diff --git a/Bin/Mail.dll b/Bin/Mail.dll new file mode 100644 index 000000000..0ced80f4f Binary files /dev/null and b/Bin/Mail.dll differ diff --git a/Bin/Microsoft.Bcl.AsyncInterfaces.dll b/Bin/Microsoft.Bcl.AsyncInterfaces.dll index abe9406cb..6031ba1e9 100644 Binary files a/Bin/Microsoft.Bcl.AsyncInterfaces.dll and b/Bin/Microsoft.Bcl.AsyncInterfaces.dll differ diff --git a/Bin/Microsoft.Bcl.AsyncInterfaces.dll.refresh b/Bin/Microsoft.Bcl.AsyncInterfaces.dll.refresh new file mode 100644 index 000000000..51a05b01f Binary files /dev/null and b/Bin/Microsoft.Bcl.AsyncInterfaces.dll.refresh differ diff --git a/Bin/Microsoft.Bcl.AsyncInterfaces.xml b/Bin/Microsoft.Bcl.AsyncInterfaces.xml index cb1744f60..e75808ac8 100644 --- a/Bin/Microsoft.Bcl.AsyncInterfaces.xml +++ b/Bin/Microsoft.Bcl.AsyncInterfaces.xml @@ -151,6 +151,10 @@ Provides a type that can be used to configure how awaits on an are performed. + + Asynchronously releases the unmanaged resources used by the . + A task that represents the asynchronous dispose operation. + Provides an awaitable async enumerable that enables cancelable iteration and configured awaits. @@ -166,6 +170,10 @@ The configured enumerable. This will replace any previous set by for this iteration. + + Returns an enumerator that iterates asynchronously through collections that enables cancelable iteration and configured awaits. + An enumerator for the class. + Provides an awaitable async enumerator that enables cancelable iteration and configured awaits. @@ -186,6 +194,83 @@ resetting unmanaged resources asynchronously. + + Allows users of async-enumerable methods to mark the parameter that should receive the cancellation token value from . + + + Initializes a new instance of the class. + + + + Attribute used to indicate a source generator should create a function for marshalling + arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time. + + + This attribute is meaningless if the source generator associated with it is not enabled. + The current built-in source generator only supports C# and only supplies an implementation when + applied to static, partial, non-generic methods. + + + + + Initializes a new instance of the . + + Name of the library containing the import. + + + + Gets the name of the library containing the import. + + + + + Gets or sets the name of the entry point to be called. + + + + + Gets or sets how to marshal string arguments to the method. + + + If this field is set to a value other than , + must not be specified. + + + + + Gets or sets the used to control how string arguments to the method are marshalled. + + + If this field is specified, must not be specified + or must be set to . + + + + + Gets or sets whether the callee sets an error (SetLastError on Windows or errno + on other platforms) before returning from the attributed method. + + + + + Specifies how strings should be marshalled for generated p/invokes + + + + + Indicates the user is suppling a specific marshaller in . + + + + + Use the platform-provided UTF-8 marshaller. + + + + + Use the platform-provided UTF-16 marshaller. + + Exposes an enumerator that provides asynchronous iteration over values of a specified type. The type of values to enumerate. @@ -219,5 +304,114 @@ resetting unmanaged resources asynchronously. + + Specifies that null is allowed as an input even if the corresponding type disallows it. + + + Specifies that null is disallowed as an input even if the corresponding type allows it. + + + Specifies that an output may be null even if the corresponding type disallows it. + + + Specifies that an output will not be null even if the corresponding type allows it. Specifies that an input argument was not null when the call returns. + + + Specifies that when a method returns , the parameter may be null even if the corresponding type disallows it. + + + Initializes the attribute with the specified return value condition. + + The return value condition. If the method returns this value, the associated parameter may be null. + + + + Gets the return value condition. + + + 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 the output will be non-null if the named parameter is non-null. + + + Initializes the attribute with the associated parameter name. + + The associated parameter name. The output will be non-null if the argument to the parameter specified is non-null. + + + + Gets the associated parameter name. + + + Applied to a method that will never return under any circumstance. + + + Specifies that the method will not return if the associated Boolean parameter is passed the specified value. + + + Initializes the attribute with the specified parameter value. + + 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. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values. + + + Initializes the attribute with a field or property member. + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the list of field and property members. + + The list of field and property members that are promised to be not-null. + + + + Gets field or property member names. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values when returning with the specified return value condition. + + + Initializes the attribute with the specified return value condition and a field or property member. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the specified return value condition and list of field and property members. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The list of field and property members that are promised to be not-null. + + + + Gets the return value condition. + + + Gets field or property member names. + diff --git a/Bin/Microsoft.Extensions.DependencyInjection.Abstractions.dll b/Bin/Microsoft.Extensions.DependencyInjection.Abstractions.dll index d69b5ea1a..3298f8dce 100644 Binary files a/Bin/Microsoft.Extensions.DependencyInjection.Abstractions.dll and b/Bin/Microsoft.Extensions.DependencyInjection.Abstractions.dll differ diff --git a/Bin/Microsoft.Extensions.DependencyInjection.Abstractions.dll.refresh b/Bin/Microsoft.Extensions.DependencyInjection.Abstractions.dll.refresh new file mode 100644 index 000000000..46f0f83b8 Binary files /dev/null and b/Bin/Microsoft.Extensions.DependencyInjection.Abstractions.dll.refresh differ diff --git a/Bin/Microsoft.Extensions.DependencyInjection.Abstractions.xml b/Bin/Microsoft.Extensions.DependencyInjection.Abstractions.xml index 4a84b3a8a..ca535c8d3 100644 --- a/Bin/Microsoft.Extensions.DependencyInjection.Abstractions.xml +++ b/Bin/Microsoft.Extensions.DependencyInjection.Abstractions.xml @@ -1,752 +1,2515 @@ - + - - Microsoft.Extensions.DependencyInjection.Abstractions - - - - Helper code for the various activator services. - - - Create a delegate that will instantiate a type with constructor arguments provided directly - and/or from an . - The type to activate - - The types of objects, in order, that will be passed to the returned function as its second parameter - - A factory that will instantiate instanceType using an + + Microsoft.Extensions.DependencyInjection.Abstractions + + + + + Helper code for the various activator services. + + + + + Instantiate a type with constructor arguments provided directly and/or from an . + + The service provider used to resolve dependencies + The type to activate + Constructor arguments not provided by the . + An activated object of type instanceType + + + + Create a delegate that will instantiate a type with constructor arguments provided directly + and/or from an . + + The type to activate + + The types of objects, in order, that will be passed to the returned function as its second parameter + + + A factory that will instantiate instanceType using an and an argument array containing objects matching the types defined in argumentTypes - . - - - Instantiate a type with constructor arguments provided directly and/or from an . - The service provider used to resolve dependencies - The type to activate - Constructor arguments not provided by the . - An activated object of type instanceType - - - Instantiate a type with constructor arguments provided directly and/or from an . - The service provider used to resolve dependencies - Constructor arguments not provided by the . - The type to activate - An activated object of type T - - - Retrieve an instance of the given type from the service provider. If one is not found then instantiate it directly. - The service provider - The type of the service - The resolved service or created instance - - - Retrieve an instance of the given type from the service provider. If one is not found then instantiate it directly. - The service provider used to resolve dependencies - The type of the service - The resolved service or created instance - - - Marks the constructor to be used when activating type using . - - - - Extension methods for adding and removing services to an . - - - Adds the specified to the . - The . - The to add. - A reference to the current instance of . - - - Adds a sequence of to the . - The . - The s to add. - A reference to the current instance of . - - - Removes all services of type in . - The . - The service type to remove. - The for chaining. - - - Removes all services of type in . - The . - - The for chaining. - - - Removes the first service in with the same service type - as and adds to the collection. - The . - The to replace with. - The for chaining. - - - Adds the specified to the if the - service type hasn't already been registered. - The . - The to add. - - - Adds the specified to the if the - service type hasn't already been registered. - The . - The s to add. - - - Adds a if an existing descriptor with the same - and an implementation that does not already exist in . - The . - The . - - - Adds the specified s if an existing descriptor with the same - and an implementation that does not already exist - in . - The . - The s. - - - Adds the specified as a service - to the if the service type hasn't already been registered. - The . - The type of the service to register. - - - Adds the specified as a service - using the factory specified in - to the if the service type hasn't already been registered. - The . - The type of the service to register. - The factory that creates the service. - - - Adds the specified as a service - with the implementation - to the if the service type hasn't already been registered. - The . - The type of the service to register. - The implementation type of the service. - - - Adds the specified as a service - to the if the service type hasn't already been registered. - The . - The type of the service to add. - - - Adds the specified as a service - using the factory specified in - to the if the service type hasn't already been registered. - The . - The factory that creates the service. - The type of the service to add. - - - Adds the specified as a service - implementation type specified in - to the if the service type hasn't already been registered. - The . - The type of the service to add. - The type of the implementation to use. - - - Adds the specified as a service - to the if the service type hasn't already been registered. - The . - The type of the service to register. - - - Adds the specified as a service - using the factory specified in - to the if the service type hasn't already been registered. - The . - The type of the service to register. - The factory that creates the service. - - - Adds the specified as a service - with the implementation - to the if the service type hasn't already been registered. - The . - The type of the service to register. - The implementation type of the service. - - - Adds the specified as a service - to the if the service type hasn't already been registered. - The . - The type of the service to add. - - - Adds the specified as a service - with an instance specified in - to the if the service type hasn't already been registered. - The . - The instance of the service to add. - The type of the service to add. - - - Adds the specified as a service - using the factory specified in - to the if the service type hasn't already been registered. - The . - The factory that creates the service. - The type of the service to add. - - - Adds the specified as a service - implementation type specified in - to the if the service type hasn't already been registered. - The . - The type of the service to add. - The type of the implementation to use. - - - Adds the specified as a service - to the if the service type hasn't already been registered. - The . - The type of the service to register. - - - Adds the specified as a service - using the factory specified in - to the if the service type hasn't already been registered. - The . - The type of the service to register. - The factory that creates the service. - - - Adds the specified as a service - with the implementation - to the if the service type hasn't already been registered. - The . - The type of the service to register. - The implementation type of the service. - - - Adds the specified as a service - to the if the service type hasn't already been registered. - The . - The type of the service to add. - - - Adds the specified as a service - using the factory specified in - to the if the service type hasn't already been registered. - The . - The factory that creates the service. - The type of the service to add. - - - Adds the specified as a service - implementation type specified in - to the if the service type hasn't already been registered. - The . - The type of the service to add. - The type of the implementation to use. - - - Specifies the contract for a collection of service descriptors. - - - Provides an extension point for creating a container specific builder and an . - - - - Creates a container builder from an . - The collection of services - A container builder that can be used to create an . - - - Creates an from the container builder. - The container builder - An - - - The method ends the scope lifetime. Once Dispose + + + + + Create a delegate that will instantiate a type with constructor arguments provided directly + and/or from an . + + The type to activate + + The types of objects, in order, that will be passed to the returned function as its second parameter + + + A factory that will instantiate type T using an + and an argument array containing objects matching the types defined in argumentTypes + + + + + Instantiate a type with constructor arguments provided directly and/or from an . + + The type to activate + The service provider used to resolve dependencies + Constructor arguments not provided by the . + An activated object of type T + + + + Retrieve an instance of the given type from the service provider. If one is not found then instantiate it directly. + + The type of the service + The service provider used to resolve dependencies + The resolved service or created instance + + + + Retrieve an instance of the given type from the service provider. If one is not found then instantiate it directly. + + The service provider + The type of the service + The resolved service or created instance + + + + Marks the constructor to be used when activating type using . + + + + + An implementation that implements . + + + + + Initializes a new instance of the struct. + Wraps an instance of . + + The instance to wrap. + + + + + + + + + + + + + Extension methods for adding and removing services to an . + + + + + Adds the specified to the . + + The . + The to add. + A reference to the current instance of . + + + + Adds a sequence of to the . + + The . + The s to add. + A reference to the current instance of . + + + + Adds the specified to the if the + service type hasn't already been registered. + + The . + The to add. + + + + Adds the specified to the if the + service type hasn't already been registered. + + The . + The s to add. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + + + + Adds the specified as a service + with the implementation + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The implementation type of the service. + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The factory that creates the service. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + + + + Adds the specified as a service + implementation type specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The type of the implementation to use. + The . + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + The factory that creates the service. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + + + + Adds the specified as a service + with the implementation + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The implementation type of the service. + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The factory that creates the service. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + + + + Adds the specified as a service + implementation type specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The type of the implementation to use. + The . + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + The factory that creates the service. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + + + + Adds the specified as a service + with the implementation + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The implementation type of the service. + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The factory that creates the service. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + + + + Adds the specified as a service + implementation type specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The type of the implementation to use. + The . + + + + Adds the specified as a service + with an instance specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + The instance of the service to add. + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + The factory that creates the service. + + + + Adds a if an existing descriptor with the same + and an implementation that does not already exist + in . + + The . + The . + + Use when registering a service implementation of a + service type that + supports multiple registrations of the same service type. Using + is not idempotent and can add + duplicate + instances if called twice. Using + will prevent registration + of multiple implementation types. + + + + + Adds the specified s if an existing descriptor with the same + and an implementation that does not already exist + in . + + The . + The s. + + Use when registering a service + implementation of a service type that + supports multiple registrations of the same service type. Using + is not idempotent and can add + duplicate + instances if called twice. Using + will prevent registration + of multiple implementation types. + + + + + Removes the first service in with the same service type + as and adds to the collection. + + The . + The to replace with. + The for chaining. + + + + Removes all services of type in . + + The . + The for chaining. + + + + Removes all services of type in . + + The . + The service type to remove. + The for chaining. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The service key. + + + + Adds the specified as a service + with the implementation + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The service key. + The implementation type of the service. + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The service key. + The factory that creates the service. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + The service key. + + + + Adds the specified as a service + implementation type specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The type of the implementation to use. + The . + The service key. + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + The service key. + The factory that creates the service. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The service key. + + + + Adds the specified as a service + with the implementation + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The service key. + The implementation type of the service. + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The service key. + The factory that creates the service. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + The service key. + + + + Adds the specified as a service + implementation type specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The type of the implementation to use. + The . + The service key. + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + The factory that creates the service. + The service key. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The service key. + + + + Adds the specified as a service + with the implementation + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The service key. + The implementation type of the service. + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The . + The type of the service to register. + The service key. + The factory that creates the service. + + + + Adds the specified as a service + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + The service key. + + + + Adds the specified as a service + implementation type specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The type of the implementation to use. + The . + The service key. + + + + Adds the specified as a service + with an instance specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + The service key. + The instance of the service to add. + + + + Adds the specified as a service + using the factory specified in + to the if the service type hasn't already been registered. + + The type of the service to add. + The . + The service key. + The factory that creates the service. + + + + Removes all services of type in . + + The . + The service key. + The for chaining. + + + + Removes all services of type in . + + The . + The service type to remove. + The service key. + The for chaining. + + + + Indicates that the parameter should be bound using the keyed service registered with the specified key. + + + + + Creates a new instance. + + The key of the keyed service to bind to. + + + + The key of the keyed service to bind to. + + + + + IKeyedServiceProvider is a service provider that can be used to retrieve services using a key in addition + to a type. + + + + + Gets the service object of the specified type. + + An object that specifies the type of service object to get. + An object that specifies the key of service object to get. + A service object of type serviceType. -or- null if there is no service object of type serviceType. + + + + Gets service of type from the implementing + this interface. + + An object that specifies the type of service object to get. + The of the service. + A service object of type . + Throws an exception if the cannot create the object. + + + + Statics for use with . + + + + + Represents a key that matches any key. + + + + + Specifies the contract for a collection of service descriptors. + + + + + Provides an extension point for creating a container specific builder and an . + + + + + Creates a container builder from an . + + The collection of services + A container builder that can be used to create an . + + + + Creates an from the container builder. + + The container builder + An + + + + Optional service used to determine if the specified type with the specified service key is available + from the . + + + + + Determines if the specified service type with the specified service key is available from the + . + + An object that specifies the type of service object to test. + The of the service. + true if the specified service is a available, false if it is not. + + + + Optional service used to determine if the specified type is available from the . + + + + + Determines if the specified service type is available from the . + + An object that specifies the type of service object to test. + true if the specified service is a available, false if it is not. + + + + The method ends the scope lifetime. Once Dispose is called, any scoped services that have been resolved from - will be - disposed. - - - The used to resolve dependencies from the scope. - - - A factory for creating instances of , which is used to create - services within a scope. - - - Create an which - contains an used to resolve dependencies from a - newly created scope. - - An controlling the + will be + disposed. + + + + + The used to resolve dependencies from the scope. + + + + + A factory for creating instances of , which is used to create + services within a scope. + + + + + Create an which + contains an used to resolve dependencies from a + newly created scope. + + + An controlling the lifetime of the scope. Once this is disposed, any scoped services that have been resolved - from the + from the will also be disposed. - . - - - Optional contract used by - to resolve services if supported by . - - - Gets service of type from the implementing - this interface. - An object that specifies the type of service object to get. - A service object of type . - Throws an exception if the cannot create the object. - - - The result of . - The to get service arguments from. - Additional constructor arguments. - The instantiated type. - - - Extension methods for adding services to an . - - - Adds a scoped service of the type specified in to the - specified . - The to add the service to. - The type of the service to register and the implementation to use. - A reference to this instance after the operation has completed. - - - Adds a scoped service of the type specified in with a - factory specified in to the - specified . - The to add the service to. - The type of the service to register. - The factory that creates the service. - A reference to this instance after the operation has completed. - - - Adds a scoped service of the type specified in with an - implementation of the type specified in to the - specified . - The to add the service to. - The type of the service to register. - The implementation type of the service. - A reference to this instance after the operation has completed. - - - Adds a scoped service of the type specified in to the - specified . - The to add the service to. - The type of the service to add. - A reference to this instance after the operation has completed. - - - Adds a scoped service of the type specified in with a - factory specified in to the - specified . - The to add the service to. - The factory that creates the service. - The type of the service to add. - A reference to this instance after the operation has completed. - - - Adds a scoped service of the type specified in with an - implementation type specified in to the - specified . - The to add the service to. - The type of the service to add. - The type of the implementation to use. - A reference to this instance after the operation has completed. - - - Adds a scoped service of the type specified in with an + + + + + Optional contract used by + to resolve services if supported by . + + + + + Gets service of type from the implementing + this interface. + + An object that specifies the type of service object to get. + A service object of type . + Throws an exception if the cannot create the object. + + + + The result of . + + The to get service arguments from. + Additional constructor arguments. + The instantiated type. + + + + The result of . A delegate to specify a factory method to call to instantiate an instance of type `T` + + The type of the instance being returned + The to get service arguments from. + Additional constructor arguments. + An instance of T + + + + Default implementation of . + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Makes this collection read-only. + + + After the collection is marked as read-only, any further attempt to modify it throws an . + + + + + Extension methods for adding services to an . + + + Extension methods for adding services to an . + + + + + Adds a transient service of the type specified in with an + implementation of the type specified in to the + specified . + + The to add the service to. + The type of the service to register. + The implementation type of the service. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in with a + factory specified in to the + specified . + + The to add the service to. + The type of the service to register. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in with an + implementation type specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in to the + specified . + + The to add the service to. + The type of the service to register and the implementation to use. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in to the + specified . + + The type of the service to add. + The to add the service to. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in with a + factory specified in to the + specified . + + The type of the service to add. + The to add the service to. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in with an implementation type specified in using the - factory specified in to the - specified . - The to add the service to. - The factory that creates the service. - The type of the service to add. - The type of the implementation to use. - A reference to this instance after the operation has completed. - - - Adds a singleton service of the type specified in to the - specified . - The to add the service to. - The type of the service to register and the implementation to use. - A reference to this instance after the operation has completed. - - - Adds a singleton service of the type specified in with a - factory specified in to the - specified . - The to add the service to. - The type of the service to register. - The factory that creates the service. - A reference to this instance after the operation has completed. - - - Adds a singleton service of the type specified in with an - instance specified in to the - specified . - The to add the service to. - The type of the service to register. - The instance of the service. - A reference to this instance after the operation has completed. - - - Adds a singleton service of the type specified in with an - implementation of the type specified in to the - specified . - The to add the service to. - The type of the service to register. - The implementation type of the service. - A reference to this instance after the operation has completed. - - - Adds a singleton service of the type specified in to the - specified . - The to add the service to. - The type of the service to add. - A reference to this instance after the operation has completed. - - - Adds a singleton service of the type specified in with an - instance specified in to the - specified . - The to add the service to. - The instance of the service. - - A reference to this instance after the operation has completed. - - - Adds a singleton service of the type specified in with a - factory specified in to the - specified . - The to add the service to. - The factory that creates the service. - The type of the service to add. - A reference to this instance after the operation has completed. - - - Adds a singleton service of the type specified in with an - implementation type specified in to the - specified . - The to add the service to. - The type of the service to add. - The type of the implementation to use. - A reference to this instance after the operation has completed. - - - Adds a singleton service of the type specified in with an + factory specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in with an + implementation of the type specified in to the + specified . + + The to add the service to. + The type of the service to register. + The implementation type of the service. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in with a + factory specified in to the + specified . + + The to add the service to. + The type of the service to register. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in with an + implementation type specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in to the + specified . + + The to add the service to. + The type of the service to register and the implementation to use. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in to the + specified . + + The type of the service to add. + The to add the service to. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in with a + factory specified in to the + specified . + + The type of the service to add. + The to add the service to. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in with an implementation type specified in using the - factory specified in to the - specified . - The to add the service to. - The factory that creates the service. - The type of the service to add. - The type of the implementation to use. - A reference to this instance after the operation has completed. - - - Adds a transient service of the type specified in to the - specified . - The to add the service to. - The type of the service to register and the implementation to use. - A reference to this instance after the operation has completed. - - - Adds a transient service of the type specified in with a - factory specified in to the - specified . - The to add the service to. - The type of the service to register. - The factory that creates the service. - A reference to this instance after the operation has completed. - - - Adds a transient service of the type specified in with an - implementation of the type specified in to the - specified . - The to add the service to. - The type of the service to register. - The implementation type of the service. - A reference to this instance after the operation has completed. - - - Adds a transient service of the type specified in to the - specified . - The to add the service to. - The type of the service to add. - A reference to this instance after the operation has completed. - - - Adds a transient service of the type specified in with a - factory specified in to the - specified . - The to add the service to. - The factory that creates the service. - The type of the service to add. - A reference to this instance after the operation has completed. - - - Adds a transient service of the type specified in with an - implementation type specified in to the - specified . - The to add the service to. - The type of the service to add. - The type of the implementation to use. - A reference to this instance after the operation has completed. - - - Adds a transient service of the type specified in with an + factory specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with an + implementation of the type specified in to the + specified . + + The to add the service to. + The type of the service to register. + The implementation type of the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with a + factory specified in to the + specified . + + The to add the service to. + The type of the service to register. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with an + implementation type specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in to the + specified . + + The to add the service to. + The type of the service to register and the implementation to use. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in to the + specified . + + The type of the service to add. + The to add the service to. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with a + factory specified in to the + specified . + + The type of the service to add. + The to add the service to. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with an implementation type specified in using the - factory specified in to the - specified . - The to add the service to. - The factory that creates the service. - The type of the service to add. - The type of the implementation to use. - A reference to this instance after the operation has completed. - - - Describes a service with its service type, implementation, and lifetime. - - - Initializes a new instance of with the specified . - The of the service. - A factory used for creating service instances. - The of the service. - - - Initializes a new instance of with the specified - as a . - The of the service. - The instance implementing the service. - - - Initializes a new instance of with the specified . - The of the service. - The implementing the service. - The of the service. - - - Creates an instance of with the specified - , , - and . - The type of the service. - A factory to create new instances of the service implementation. - The lifetime of the service. - A new instance of . - - - Creates an instance of with the specified - , , - and . - The type of the service. - The type of the implementation. - The lifetime of the service. - A new instance of . - - - Creates an instance of with the specified - , , - and the lifetime. - The type of the service. - A factory to create new instances of the service implementation. - A new instance of . - - - Creates an instance of with the specified - and - and the lifetime. - The type of the service. - The type of the implementation. - A new instance of . - - - Creates an instance of with the specified - , , - and the lifetime. - A factory to create new instances of the service implementation. - The type of the service. - A new instance of . - - - Creates an instance of with the specified - , , - and the lifetime. - The type of the service. - The type of the implementation. - A new instance of . - - - Creates an instance of with the specified - , , - , - and the lifetime. - A factory to create new instances of the service implementation. - The type of the service. - The type of the implementation. - A new instance of . - - - Creates an instance of with the specified - , , - and the lifetime. - The type of the service. - A factory to create new instances of the service implementation. - A new instance of . - - - Creates an instance of with the specified - , , - and the lifetime. - The type of the service. - The instance of the implementation. - A new instance of . - - - Creates an instance of with the specified - and - and the lifetime. - The type of the service. - The type of the implementation. - A new instance of . - - - Creates an instance of with the specified - , , - and the lifetime. - The instance of the implementation. - The type of the service. - A new instance of . - - - Creates an instance of with the specified - , , - and the lifetime. - A factory to create new instances of the service implementation. - The type of the service. - A new instance of . - - - Creates an instance of with the specified - , , - and the lifetime. - The type of the service. - The type of the implementation. - A new instance of . - - - Creates an instance of with the specified - , , - , - and the lifetime. - A factory to create new instances of the service implementation. - The type of the service. - The type of the implementation. - A new instance of . - - - - Creates an instance of with the specified - , , - and the lifetime. - The type of the service. - A factory to create new instances of the service implementation. - A new instance of . - - - Creates an instance of with the specified - and - and the lifetime. - The type of the service. - The type of the implementation. - A new instance of . - - - Creates an instance of with the specified - , , - and the lifetime. - A factory to create new instances of the service implementation. - The type of the service. - A new instance of . - - - Creates an instance of with the specified - , , - and the lifetime. - The type of the service. - The type of the implementation. - A new instance of . - - - Creates an instance of with the specified - , , - , - and the lifetime. - A factory to create new instances of the service implementation. - The type of the service. - The type of the implementation. - A new instance of . - - - - - - - - Specifies the lifetime of a service in an . - - - Specifies that a new instance of the service will be created for each scope. - - - Specifies that a single instance of the service will be created. - - - Specifies that a new instance of the service will be created every time it is requested. - - - Extension methods for getting services from an . - - - Creates a new that can be used to resolve scoped services. - The to create the scope from. - A that can be used to resolve scoped services. - - - Get service of type from the . - The to retrieve the service object from. - An object that specifies the type of service object to get. - There is no service of type . - A service object of type . - - - Get service of type from the . - The to retrieve the service object from. - The type of service object to get. - There is no service of type . - A service object of type . - - - Get service of type from the . - The to retrieve the service object from. - The type of service object to get. - A service object of type or null if there is no such service. - - - Get an enumeration of services of type from the . - The to retrieve the services from. - An object that specifies the type of service object to get. - An enumeration of services of type . - - - Get an enumeration of services of type from the . - The to retrieve the services from. - The type of service object to get. - An enumeration of services of type . - - - \ No newline at end of file + factory specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with an + instance specified in to the + specified . + + The to add the service to. + The type of the service to register. + The instance of the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with an + instance specified in to the + specified . + + The to add the service to. + The instance of the service. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in with an + implementation of the type specified in to the + specified . + + The to add the service to. + The type of the service to register. + The of the service. + The implementation type of the service. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in with a + factory specified in to the + specified . + + The to add the service to. + The type of the service to register. + The of the service. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in with an + implementation type specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + The of the service. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in to the + specified . + + The to add the service to. + The type of the service to register and the implementation to use. + The of the service. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in to the + specified . + + The type of the service to add. + The to add the service to. + The of the service. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in with a + factory specified in to the + specified . + + The type of the service to add. + The to add the service to. + The of the service. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a transient service of the type specified in with an + implementation type specified in using the + factory specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + The of the service. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in with an + implementation of the type specified in to the + specified . + + The to add the service to. + The type of the service to register. + The of the service. + The implementation type of the service. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in with a + factory specified in to the + specified . + + The to add the service to. + The type of the service to register. + The of the service. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in with an + implementation type specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + The of the service. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in to the + specified . + + The to add the service to. + The type of the service to register and the implementation to use. + The of the service. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in to the + specified . + + The type of the service to add. + The to add the service to. + The of the service. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in with a + factory specified in to the + specified . + + The type of the service to add. + The to add the service to. + The of the service. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a scoped service of the type specified in with an + implementation type specified in using the + factory specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + The of the service. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with an + implementation of the type specified in to the + specified . + + The to add the service to. + The type of the service to register. + The of the service. + The implementation type of the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with a + factory specified in to the + specified . + + The to add the service to. + The type of the service to register. + The of the service. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with an + implementation type specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + The of the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in to the + specified . + + The to add the service to. + The type of the service to register and the implementation to use. + The of the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in to the + specified . + + The type of the service to add. + The to add the service to. + The of the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with a + factory specified in to the + specified . + + The type of the service to add. + The to add the service to. + The of the service. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with an + implementation type specified in using the + factory specified in to the + specified . + + The type of the service to add. + The type of the implementation to use. + The to add the service to. + The of the service. + The factory that creates the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with an + instance specified in to the + specified . + + The to add the service to. + The type of the service to register. + The of the service. + The instance of the service. + A reference to this instance after the operation has completed. + + + + + Adds a singleton service of the type specified in with an + instance specified in to the + specified . + + The to add the service to. + The of the service. + The instance of the service. + A reference to this instance after the operation has completed. + + + + + Describes a service with its service type, implementation, and lifetime. + + + + + Initializes a new instance of with the specified . + + The of the service. + The implementing the service. + The of the service. + + + + Initializes a new instance of with the specified . + + The of the service. + The of the service. + The implementing the service. + The of the service. + + + + Initializes a new instance of with the specified + as a . + + The of the service. + The instance implementing the service. + + + + Initializes a new instance of with the specified + as a . + + The of the service. + The of the service. + The instance implementing the service. + + + + Initializes a new instance of with the specified . + + The of the service. + A factory used for creating service instances. + The of the service. + + + + Initializes a new instance of with the specified . + + The of the service. + The of the service. + A factory used for creating service instances. + The of the service. + + + + Gets the of the service. + + + + + Get the key of the service, if applicable. + + + + + Gets the of the service. + + + + + Gets the that implements the service. + + + + + Gets the that implements the service. + + + + + Gets the instance that implements the service. + + + + + Gets the instance that implements the service. + + + + + Gets the factory used for creating service instances. + + + + + Gets the factory used for creating Keyed service instances. + + + + + Indicates whether the service is a keyed service. + + + + + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The type of the implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The type of the implementation. + The of the service. + A new instance of . + + + + Creates an instance of with the specified + and + and the lifetime. + + The type of the service. + The type of the implementation. + A new instance of . + + + + Creates an instance of with the specified + and + and the lifetime. + + The type of the service. + The of the service. + The type of the implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + , + and the lifetime. + + The type of the service. + The type of the implementation. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + , + and the lifetime. + + The type of the service. + The type of the implementation. + The of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The type of the implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The type of the implementation. + The of the service. + A new instance of . + + + + Creates an instance of with the specified + and + and the lifetime. + + The type of the service. + The type of the implementation. + A new instance of . + + + + Creates an instance of with the specified + and + and the lifetime. + + The type of the service. + The of the service. + The type of the implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + , + and the lifetime. + + The type of the service. + The type of the implementation. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + , + and the lifetime. + + The type of the service. + The type of the implementation. + The of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The type of the implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The type of the implementation. + The of the service. + A new instance of . + + + + Creates an instance of with the specified + and + and the lifetime. + + The type of the service. + The type of the implementation. + A new instance of . + + + + Creates an instance of with the specified + and + and the lifetime. + + The type of the service. + The of the service. + The type of the implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + , + and the lifetime. + + The type of the service. + The type of the implementation. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + , + and the lifetime. + + The type of the service. + The type of the implementation. + The of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The of the service. + A factory to create new instances of the service implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The instance of the implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The of the service. + The instance of the implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The instance of the implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and the lifetime. + + The type of the service. + The of the service. + The instance of the implementation. + A new instance of . + + + + Creates an instance of with the specified + , , + and . + + The type of the service. + The type of the implementation. + The lifetime of the service. + A new instance of . + + + + Creates an instance of with the specified + , , + and . + + The type of the service. + The of the service. + The type of the implementation. + The lifetime of the service. + A new instance of . + + + + Creates an instance of with the specified + , , + and . + + The type of the service. + A factory to create new instances of the service implementation. + The lifetime of the service. + A new instance of . + + + + Creates an instance of with the specified + , , + and . + + The type of the service. + The of the service. + A factory to create new instances of the service implementation. + The lifetime of the service. + A new instance of . + + + + ServiceKeyAttribute can be specified on a parameter to inject the key that was used for + registration/resolution. + + + + + Specifies the lifetime of a service in an . + + + + + Specifies that a single instance of the service will be created. + + + + + Specifies that a new instance of the service will be created for each scope. + + + In ASP.NET Core applications a scope is created around each server request. + + + + + Specifies that a new instance of the service will be created every time it is requested. + + + + + Extension methods for getting services from an . + + + + + Get service of type from the . + + The type of service object to get. + The to retrieve the service object from. + An object that specifies the key of service object to get. + A service object of type or null if there is no such service. + + + + Get service of type from the . + + The to retrieve the service object from. + An object that specifies the type of service object to get. + An object that specifies the key of service object to get. + A service object of type . + There is no service of type . + + + + Get service of type from the . + + The type of service object to get. + The to retrieve the service object from. + An object that specifies the key of service object to get. + A service object of type . + There is no service of type . + + + + Get an enumeration of services of type from the . + + The type of service object to get. + The to retrieve the services from. + An object that specifies the key of service object to get. + An enumeration of services of type . + + + + Get an enumeration of services of type from the . + + The to retrieve the services from. + An object that specifies the type of service object to get. + An object that specifies the key of service object to get. + An enumeration of services of type . + + + + Extension methods for getting services from an . + + + + + Get service of type from the . + + The type of service object to get. + The to retrieve the service object from. + A service object of type or null if there is no such service. + + + + Get service of type from the . + + The to retrieve the service object from. + An object that specifies the type of service object to get. + A service object of type . + There is no service of type . + + + + Get service of type from the . + + The type of service object to get. + The to retrieve the service object from. + A service object of type . + There is no service of type . + + + + Get an enumeration of services of type from the . + + The type of service object to get. + The to retrieve the services from. + An enumeration of services of type . + + + + Get an enumeration of services of type from the . + + The to retrieve the services from. + An object that specifies the type of service object to get. + An enumeration of services of type . + + + + Creates a new that can be used to resolve scoped services. + + The to create the scope from. + A that can be used to resolve scoped services. + + + + Creates a new that can be used to resolve scoped services. + + The to create the scope from. + An that can be used to resolve scoped services. + + + + Creates a new that can be used to resolve scoped services. + + The to create the scope from. + An that can be used to resolve scoped services. + + + Throws an if is null. + The reference type argument to validate as non-null. + The name of the parameter with which corresponds. + + + + Throws either an or an + if the specified string is or whitespace respectively. + + String to be checked for or whitespace. + The name of the parameter being checked. + The original value of . + + + + Attribute used to indicate a source generator should create a function for marshalling + arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time. + + + This attribute is meaningless if the source generator associated with it is not enabled. + The current built-in source generator only supports C# and only supplies an implementation when + applied to static, partial, non-generic methods. + + + + + Initializes a new instance of the . + + Name of the library containing the import. + + + + Gets the name of the library containing the import. + + + + + Gets or sets the name of the entry point to be called. + + + + + Gets or sets how to marshal string arguments to the method. + + + If this field is set to a value other than , + must not be specified. + + + + + Gets or sets the used to control how string arguments to the method are marshalled. + + + If this field is specified, must not be specified + or must be set to . + + + + + Gets or sets whether the callee sets an error (SetLastError on Windows or errno + on other platforms) before returning from the attributed method. + + + + + Specifies how strings should be marshalled for generated p/invokes + + + + + Indicates the user is suppling a specific marshaller in . + + + + + Use the platform-provided UTF-8 marshaller. + + + + + Use the platform-provided UTF-16 marshaller. + + + + + Indicates that certain members on a specified are accessed dynamically, + for example through . + + + This allows tools to understand which members are being accessed during the execution + of a program. + + This attribute is valid on members whose type is or . + + When this attribute is applied to a location of type , the assumption is + that the string represents a fully qualified type name. + + When this attribute is applied to a class, interface, or struct, the members specified + can be accessed dynamically on instances returned from calling + on instances of that class, interface, or struct. + + If the attribute is applied to a method it's treated as a special case and it implies + the attribute should be applied to the "this" parameter of the method. As such the attribute + should only be used on instance methods of types assignable to System.Type (or string, but no methods + will use it there). + + + + + Initializes a new instance of the class + with the specified member types. + + The types of members dynamically accessed. + + + + Gets the which specifies the type + of members dynamically accessed. + + + + + Specifies the types of members that are dynamically accessed. + + This enumeration has a attribute that allows a + bitwise combination of its member values. + + + + + Specifies no members. + + + + + Specifies the default, parameterless public constructor. + + + + + Specifies all public constructors. + + + + + Specifies all non-public constructors. + + + + + Specifies all public methods. + + + + + Specifies all non-public methods. + + + + + Specifies all public fields. + + + + + Specifies all non-public fields. + + + + + Specifies all public nested types. + + + + + Specifies all non-public nested types. + + + + + Specifies all public properties. + + + + + Specifies all non-public properties. + + + + + Specifies all public events. + + + + + Specifies all non-public events. + + + + + Specifies all interfaces implemented by the type. + + + + + Specifies all members. + + + + + Suppresses reporting of a specific rule violation, allowing multiple suppressions on a + single code artifact. + + + is different than + in that it doesn't have a + . So it is always preserved in the compiled assembly. + + + + + Initializes a new instance of the + class, specifying the category of the tool and the identifier for an analysis rule. + + The category for the attribute. + The identifier of the analysis rule the attribute applies to. + + + + Gets the category identifying the classification of the attribute. + + + The property describes the tool or tool analysis category + for which a message suppression attribute applies. + + + + + Gets the identifier of the analysis tool rule to be suppressed. + + + Concatenated together, the and + properties form a unique check identifier. + + + + + Gets or sets the scope of the code that is relevant for the attribute. + + + The Scope property is an optional argument that specifies the metadata scope for which + the attribute is relevant. + + + + + Gets or sets a fully qualified path that represents the target of the attribute. + + + The property is an optional argument identifying the analysis target + of the attribute. An example value is "System.IO.Stream.ctor():System.Void". + Because it is fully qualified, it can be long, particularly for targets such as parameters. + The analysis tool user interface should be capable of automatically formatting the parameter. + + + + + Gets or sets an optional argument expanding on exclusion criteria. + + + The property is an optional argument that specifies additional + exclusion where the literal metadata target is not sufficiently precise. For example, + the cannot be applied within a method, + and it may be desirable to suppress a violation against a statement in the method that will + give a rule violation, but not against all statements in the method. + + + + + Gets or sets the justification for suppressing the code analysis message. + + + + + Indicates that the specified method requires the ability to generate new code at runtime, + for example through . + + + This allows tools to understand which methods are unsafe to call when compiling ahead of time. + + + + + Initializes a new instance of the class + with the specified message. + + + A message that contains information about the usage of dynamic code. + + + + + Gets a message that contains information about the usage of dynamic code. + + + + + Gets or sets an optional URL that contains more information about the method, + why it requires dynamic code, and what options a consumer has to deal with it. + + + + Specifies that null is allowed as an input even if the corresponding type disallows it. + + + Specifies that null is disallowed as an input even if the corresponding type allows it. + + + Specifies that an output may be null even if the corresponding type disallows it. + + + Specifies that an output will not be null even if the corresponding type allows it. Specifies that an input argument was not null when the call returns. + + + Specifies that when a method returns , the parameter may be null even if the corresponding type disallows it. + + + Initializes the attribute with the specified return value condition. + + The return value condition. If the method returns this value, the associated parameter may be null. + + + + Gets the return value condition. + + + 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 the output will be non-null if the named parameter is non-null. + + + Initializes the attribute with the associated parameter name. + + The associated parameter name. The output will be non-null if the argument to the parameter specified is non-null. + + + + Gets the associated parameter name. + + + Applied to a method that will never return under any circumstance. + + + Specifies that the method will not return if the associated Boolean parameter is passed the specified value. + + + Initializes the attribute with the specified parameter value. + + 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. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values. + + + Initializes the attribute with a field or property member. + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the list of field and property members. + + The list of field and property members that are promised to be not-null. + + + + Gets field or property member names. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values when returning with the specified return value condition. + + + Initializes the attribute with the specified return value condition and a field or property member. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the specified return value condition and list of field and property members. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The list of field and property members that are promised to be not-null. + + + + Gets the return value condition. + + + Gets field or property member names. + + + Multiple constructors accepting all given argument types have been found in type '{0}'. There should only be one applicable constructor. + + + Unable to resolve service for type '{0}' while attempting to activate '{1}'. + + + A suitable constructor for type '{0}' could not be located. Ensure the type is concrete and services are registered for all parameters of a public constructor. + + + No service for type '{0}' has been registered. + + + The service collection cannot be modified because it is read-only. + + + Implementation type cannot be '{0}' because it is indistinguishable from other services registered for '{1}'. + + + Multiple constructors were marked with {0}. + + + Constructor marked with {0} does not accept all given argument types. + + + Instances of abstract classes cannot be created. + + + Multiple constructors for type '{0}' were found with length {1}. + + + Unable to resolve service for type '{0}' while attempting to activate '{1}'. + + + A suitable constructor for type '{0}' could not be located. Ensure the type is concrete and all parameters of a public constructor are either registered as services or passed as arguments. Also ensure no extraneous arguments are provided. + + + Multiple constructors accepting all given argument types have been found in type '{0}'. There should only be one applicable constructor. + + + This service provider doesn't support keyed services. + + + This service descriptor is keyed. Your service provider may not support keyed services. + + + This service descriptor is not keyed. + + + diff --git a/Bin/Microsoft.Extensions.DependencyInjection.dll b/Bin/Microsoft.Extensions.DependencyInjection.dll index ee55c1874..7f413e6af 100644 Binary files a/Bin/Microsoft.Extensions.DependencyInjection.dll and b/Bin/Microsoft.Extensions.DependencyInjection.dll differ diff --git a/Bin/Microsoft.Extensions.DependencyInjection.dll.refresh b/Bin/Microsoft.Extensions.DependencyInjection.dll.refresh new file mode 100644 index 000000000..bd80f021e Binary files /dev/null and b/Bin/Microsoft.Extensions.DependencyInjection.dll.refresh differ diff --git a/Bin/Microsoft.Extensions.DependencyInjection.xml b/Bin/Microsoft.Extensions.DependencyInjection.xml index d659711c3..2ab59f054 100644 --- a/Bin/Microsoft.Extensions.DependencyInjection.xml +++ b/Bin/Microsoft.Extensions.DependencyInjection.xml @@ -1,140 +1,666 @@ - + - - Microsoft.Extensions.DependencyInjection - - - - Default implementation of . - - - Initializes a new instance of the class - with default options. - - - Initializes a new instance of the class - with the specified . - The options to use for this instance. - - - Creates a container builder from an . - - A container builder that can be used to create an . - - - Creates an from the container builder. - - An . - - - Default implementation of . - - - - Removes all items from the . - - - Determines whether the contains a specific value. - - - if is found in the ; otherwise, . - - - Copies the elements of the to an , starting at a particular index. - - - - - Returns an enumerator that iterates through the collection. - An enumerator that can be used to iterate through the collection. - - - Determines the index of a specific item in the . - - The index of if found in the list; otherwise, -1. - - - Inserts an item to the at the specified index. - - - - - Removes the first occurrence of a specific object from the . - - - if was successfully removed from the ; otherwise, . This method also returns if is not found in the original . - - - Removes the item at the specified index. - - - - Adds an item to the . - The object to add to the . - - - Returns an enumerator that iterates through a collection. - An object that can be used to iterate through the collection. - - - Gets the number of elements contained in the . - - - Gets a value indicating whether the is read-only. - - - Gets or sets the element at the specified index. - - - - Extension methods for building a from an . - - - Creates a containing services from the provided . - The containing service descriptors. - The . - - - Creates a containing services from the provided optionally enabling service-creation and scope validation. - The containing service descriptors. - Configures various service provider behaviors including service-creation and scope validation. - The . - - - Creates a containing services from the provided - optionally enabling scope validation. - The containing service descriptors. - - to perform check verifying that scoped services never gets resolved from root provider; otherwise, . - The . - - - The default IServiceProvider. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously. - A task that represents the asynchronous dispose operation. - - - Gets the service object of the specified type. - The type of the service to get. - The service that was produced. - - - Options for configuring various behaviors of the default implementation. - - - - - to perform check verifying that all services can be created during call; otherwise, . Defaults to . - NOTE: this check doesn't verify open generics services. - - - - to perform check verifying that scoped services never gets resolved from root provider; otherwise, . Defaults to . - - - \ No newline at end of file + + Microsoft.Extensions.DependencyInjection + + + + + Pretty print a type name. + + The . + true to print a fully qualified name. + true to include generic parameter names. + true to include generic parameters. + Character to use as a delimiter in nested type names + The pretty printed type name. + + + + Default implementation of . + + + + + Initializes a new instance of the class + with default options. + + + + + Initializes a new instance of the class + with the specified . + + The options to use for this instance. + + + + + + + + + + Extension methods for building a from an . + + + + + Creates a containing services from the provided . + + The containing service descriptors. + The . + + + + Creates a containing services from the provided + optionally enabling scope validation. + + The containing service descriptors. + + true to perform check verifying that scoped services never gets resolved from root provider; otherwise false. + + The . + + + + Creates a containing services from the provided + optionally enabling scope validation. + + The containing service descriptors. + + Configures various service provider behaviors. + + The . + + + + Validates that two generic type definitions have compatible trimming annotations on their generic arguments. + + + When open generic types are used in DI, there is an error when the concrete implementation type + has [DynamicallyAccessedMembers] attributes on a generic argument type, but the interface/service type + doesn't have matching annotations. The problem is that the trimmer doesn't see the members that need to + be preserved on the type being passed to the generic argument. But when the interface/service type also has + the annotations, the trimmer will see which members need to be preserved on the closed generic argument type. + + + + Not null if throwIfCallSiteNotFound is true + + + + Verifies none of the generic type arguments are ValueTypes. + + + NativeAOT apps are not guaranteed that the native code for the closed generic of ValueType + has been generated. To catch these problems early, this verification is enabled at development-time + to inform the developer early that this scenario will not work once AOT'd. + + + + + Returns true if both keys are null or equals, or if key1 is KeyedService.AnyKey and key2 is not null + + + + + Type of service being cached + + + + + Reverse index of the service when resolved in IEnumerable<Type> where default instance gets slot 0. + For example for service collection + IService Impl1 + IService Impl2 + IService Impl3 + We would get the following cache keys: + Impl1 2 + Impl2 1 + Impl3 0 + + + + Indicates whether the current instance is equal to another instance of the same type. + An instance to compare with this instance. + true if the current instance is equal to the other instance; otherwise, false. + + + + Summary description for ServiceCallSite + + + + + The default IServiceProvider. + + + + + Gets the service object of the specified type. + + The type of the service to get. + The service that was produced. + + + + Gets the service object of the specified type with the specified key. + + The type of the service to get. + The key of the service to get. + The keyed service. + + + + Gets the service object of the specified type. Will throw if the service not found. + + The type of the service to get. + The key of the service to get. + The keyed service. + + + + + + + + + + + Options for configuring various behaviors of the default implementation. + + + + + true to perform check verifying that scoped services never gets resolved from root provider; otherwise false. Defaults to false. + + + + + true to perform check verifying that all services can be created during BuildServiceProvider call; otherwise false. Defaults to false. + NOTE: this check doesn't verify open generics services. + + + + + Indicates that certain members on a specified are accessed dynamically, + for example through . + + + This allows tools to understand which members are being accessed during the execution + of a program. + + This attribute is valid on members whose type is or . + + When this attribute is applied to a location of type , the assumption is + that the string represents a fully qualified type name. + + When this attribute is applied to a class, interface, or struct, the members specified + can be accessed dynamically on instances returned from calling + on instances of that class, interface, or struct. + + If the attribute is applied to a method it's treated as a special case and it implies + the attribute should be applied to the "this" parameter of the method. As such the attribute + should only be used on instance methods of types assignable to System.Type (or string, but no methods + will use it there). + + + + + Initializes a new instance of the class + with the specified member types. + + The types of members dynamically accessed. + + + + Gets the which specifies the type + of members dynamically accessed. + + + + + Specifies the types of members that are dynamically accessed. + + This enumeration has a attribute that allows a + bitwise combination of its member values. + + + + + Specifies no members. + + + + + Specifies the default, parameterless public constructor. + + + + + Specifies all public constructors. + + + + + Specifies all non-public constructors. + + + + + Specifies all public methods. + + + + + Specifies all non-public methods. + + + + + Specifies all public fields. + + + + + Specifies all non-public fields. + + + + + Specifies all public nested types. + + + + + Specifies all non-public nested types. + + + + + Specifies all public properties. + + + + + Specifies all non-public properties. + + + + + Specifies all public events. + + + + + Specifies all non-public events. + + + + + Specifies all interfaces implemented by the type. + + + + + Specifies all members. + + + + + Suppresses reporting of a specific rule violation, allowing multiple suppressions on a + single code artifact. + + + is different than + in that it doesn't have a + . So it is always preserved in the compiled assembly. + + + + + Initializes a new instance of the + class, specifying the category of the tool and the identifier for an analysis rule. + + The category for the attribute. + The identifier of the analysis rule the attribute applies to. + + + + Gets the category identifying the classification of the attribute. + + + The property describes the tool or tool analysis category + for which a message suppression attribute applies. + + + + + Gets the identifier of the analysis tool rule to be suppressed. + + + Concatenated together, the and + properties form a unique check identifier. + + + + + Gets or sets the scope of the code that is relevant for the attribute. + + + The Scope property is an optional argument that specifies the metadata scope for which + the attribute is relevant. + + + + + Gets or sets a fully qualified path that represents the target of the attribute. + + + The property is an optional argument identifying the analysis target + of the attribute. An example value is "System.IO.Stream.ctor():System.Void". + Because it is fully qualified, it can be long, particularly for targets such as parameters. + The analysis tool user interface should be capable of automatically formatting the parameter. + + + + + Gets or sets an optional argument expanding on exclusion criteria. + + + The property is an optional argument that specifies additional + exclusion where the literal metadata target is not sufficiently precise. For example, + the cannot be applied within a method, + and it may be desirable to suppress a violation against a statement in the method that will + give a rule violation, but not against all statements in the method. + + + + + Gets or sets the justification for suppressing the code analysis message. + + + + + Indicates that the specified method requires the ability to generate new code at runtime, + for example through . + + + This allows tools to understand which methods are unsafe to call when compiling ahead of time. + + + + + Initializes a new instance of the class + with the specified message. + + + A message that contains information about the usage of dynamic code. + + + + + Gets a message that contains information about the usage of dynamic code. + + + + + Gets or sets an optional URL that contains more information about the method, + why it requires dynamic code, and what options a consumer has to deal with it. + + + + Specifies that null is allowed as an input even if the corresponding type disallows it. + + + Specifies that null is disallowed as an input even if the corresponding type allows it. + + + Specifies that an output may be null even if the corresponding type disallows it. + + + Specifies that an output will not be null even if the corresponding type allows it. Specifies that an input argument was not null when the call returns. + + + Specifies that when a method returns , the parameter may be null even if the corresponding type disallows it. + + + Initializes the attribute with the specified return value condition. + + The return value condition. If the method returns this value, the associated parameter may be null. + + + + Gets the return value condition. + + + 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 the output will be non-null if the named parameter is non-null. + + + Initializes the attribute with the associated parameter name. + + The associated parameter name. The output will be non-null if the argument to the parameter specified is non-null. + + + + Gets the associated parameter name. + + + Applied to a method that will never return under any circumstance. + + + Specifies that the method will not return if the associated Boolean parameter is passed the specified value. + + + Initializes the attribute with the specified parameter value. + + 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. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values. + + + Initializes the attribute with a field or property member. + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the list of field and property members. + + The list of field and property members that are promised to be not-null. + + + + Gets field or property member names. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values when returning with the specified return value condition. + + + Initializes the attribute with the specified return value condition and a field or property member. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the specified return value condition and list of field and property members. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The list of field and property members that are promised to be not-null. + + + + Gets the return value condition. + + + Gets field or property member names. + + + Unable to activate type '{0}'. The following constructors are ambiguous: + + + Unable to resolve service for type '{0}' while attempting to activate '{1}'. + + + A circular dependency was detected for the service of type '{0}'. + + + No constructor for type '{0}' can be instantiated using services from the service container and default values. + + + Open generic service type '{0}' requires registering an open generic implementation type. + + + Arity of open generic service type '{0}' does not equal arity of open generic implementation type '{1}'. + + + Cannot instantiate implementation type '{0}' for service type '{1}'. + + + A suitable constructor for type '{0}' could not be located. Ensure the type is concrete and services are registered for all parameters of a public constructor. + + + Cannot consume {2} service '{0}' from {3} '{1}'. + + + Cannot resolve '{0}' from root provider because it requires {2} service '{1}'. + + + Cannot resolve {1} service '{0}' from root provider. + + + Constant value of type '{0}' can't be converted to service type '{1}' + + + Implementation type '{0}' can't be converted to service type '{1}' + + + '{0}' type only implements IAsyncDisposable. Use DisposeAsync to dispose the container. + + + GetCaptureDisposable call is supported only for main scope + + + Invalid service descriptor + + + Requested service descriptor doesn't exist. + + + Call site type {0} is not supported + + + Generic implementation type '{0}' has a DynamicallyAccessedMembers attribute applied to a generic argument type, but the service type '{1}' doesn't have a matching DynamicallyAccessedMembers attribute on its generic argument type. + + + Generic implementation type '{0}' has a DefaultConstructorConstraint ('new()' constraint), but the generic service type '{1}' doesn't. + + + Unable to create an Enumerable service of type '{0}' because it is a ValueType. Native code to support creating Enumerable services might not be available with native AOT. + + + Unable to create a generic service for type '{0}' because '{1}' is a ValueType. Native code to support creating generic services might not be available with native AOT. + + + No service for type '{0}' has been registered. + + + The type of the key used for lookup doesn't match the type in the constructor parameter with the ServiceKey attribute. + + + + Attribute used to indicate a source generator should create a function for marshalling + arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time. + + + This attribute is meaningless if the source generator associated with it is not enabled. + The current built-in source generator only supports C# and only supplies an implementation when + applied to static, partial, non-generic methods. + + + + + Initializes a new instance of the . + + Name of the library containing the import. + + + + Gets the name of the library containing the import. + + + + + Gets or sets the name of the entry point to be called. + + + + + Gets or sets how to marshal string arguments to the method. + + + If this field is set to a value other than , + must not be specified. + + + + + Gets or sets the used to control how string arguments to the method are marshalled. + + + If this field is specified, must not be specified + or must be set to . + + + + + Gets or sets whether the callee sets an error (SetLastError on Windows or errno + on other platforms) before returning from the attributed method. + + + + + Specifies how strings should be marshalled for generated p/invokes + + + + + Indicates the user is suppling a specific marshaller in . + + + + + Use the platform-provided UTF-8 marshaller. + + + + + Use the platform-provided UTF-16 marshaller. + + + + diff --git a/Bin/Microsoft.Extensions.Logging.Abstractions.dll b/Bin/Microsoft.Extensions.Logging.Abstractions.dll index 943e203ab..b8dd65244 100644 Binary files a/Bin/Microsoft.Extensions.Logging.Abstractions.dll and b/Bin/Microsoft.Extensions.Logging.Abstractions.dll differ diff --git a/Bin/Microsoft.Extensions.Logging.Abstractions.dll.refresh b/Bin/Microsoft.Extensions.Logging.Abstractions.dll.refresh new file mode 100644 index 000000000..91abdd9b5 Binary files /dev/null and b/Bin/Microsoft.Extensions.Logging.Abstractions.dll.refresh differ diff --git a/Bin/Microsoft.Extensions.Logging.Abstractions.xml b/Bin/Microsoft.Extensions.Logging.Abstractions.xml index c2054460b..105e4d849 100644 --- a/Bin/Microsoft.Extensions.Logging.Abstractions.xml +++ b/Bin/Microsoft.Extensions.Logging.Abstractions.xml @@ -1,657 +1,1350 @@ - + - - Microsoft.Extensions.Logging.Abstractions - - - - - - - - - - - - - - - - - - - - - Minimalistic logger that does nothing. - - - Begins a logical operation scope. - - - A disposable object that ends the logical operation scope on dispose. - - - Checks if the given is enabled. - - - if enabled; otherwise. - - - Writes a log entry. - - - - - - - - - Returns the shared instance of . - - - Minimalistic logger that does nothing. - - - - Returns an instance of . - - - - Begins a logical operation scope. - - - A disposable object that ends the logical operation scope on dispose. - - - Checks if the given is enabled. - - - if enabled; otherwise. - - - Writes a log entry. - - - - - - - - - An used to create instance of - that logs nothing. - - - Returns the shared instance of . - - - Creates a new instance. - - - Adds an to the logging system. - - - - Creates a new instance. - - A new instance. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Provider for the . - - - Creates a new instance. - - The instance of that was created. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Returns an instance of . - - - Identifies a logging event. The primary identifier is the "Id" property, with the "Name" property providing a short description of this type of event. - - - Initializes an instance of the struct. - The numeric identifier for this event. - The name of this event. - - - Indicates whether the current object is equal to another object of the same type. Two events are equal if they have the same id. - An object to compare with this object. - - if the current object is equal to the other parameter; otherwise, . - - - - - - - Checks if two specified instances have the same value. They are equal if they have the same Id. - The first . - The second . - - if the objects are equal. - - - Implicitly creates an EventId from the given . - The to convert to an EventId. - - - Checks if two specified instances have different values. - The first . - The second . - - if the objects are not equal. - - - - Gets the numeric identifier for this event. - - - Gets the name of this event. - - - Represents a storage of common scope data. - - - Executes callback for each currently active scope objects in order of creation. - All callbacks are guaranteed to be called inline from this method. - The callback to be executed for every scope object - The state object to be passed into the callback - The type of state to accept. - - - Adds scope object to the list. - The scope object - The token that removes scope on dispose. - - - Represents a type used to perform logging. - - - Begins a logical operation scope. - The identifier for the scope. - The type of the state to begin scope for. - A disposable object that ends the logical operation scope on dispose. - - - Checks if the given is enabled. - level to be checked. - - if enabled; otherwise. - - - Writes a log entry. - Entry will be written on this level. - Id of the event. - The entry to be written. Can be also an object. - The exception related to this entry. - Function to create a message of the and . - The type of the object to be written. - - - A generic interface for logging where the category name is derived from the specified - type name. - Generally used to enable activation of a named from dependency injection. - The type who's name is used for the logger category name. - - - Represents a type used to configure the logging system and create instances of from - the registered s. - - - Adds an to the logging system. - The . - - - Creates a new instance. - The category name for messages produced by the logger. - A new instance. - - - Represents a type that can create instances of . - - - Creates a new instance. - The category name for messages produced by the logger. - The instance of that was created. - - - Represents a that is able to consume external scope information. - - - Sets external scope information source for logger provider. - The provider of scope data. - - - Delegates to a new instance using the full name of the given type, created by the - provided . - The type. - - - Creates a new . - The factory. - - - Begins a logical operation scope. - - - A disposable object that ends the logical operation scope on dispose. - - - Checks if the given is enabled. - - - if enabled; otherwise. - - - Writes a log entry. - - - - - - - - - ILogger extension methods for common scenarios. - - - Formats the message and creates a scope. - The to create the scope in. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - A disposable scope object. Can be null. - - - Formats and writes a log message at the specified log level. - The to write to. - Entry will be written on this level. - The event id associated with the log. - The exception to log. - Format string of the log message. - An object array that contains zero or more objects to format. - - - Formats and writes a log message at the specified log level. - The to write to. - Entry will be written on this level. - The event id associated with the log. - Format string of the log message. - An object array that contains zero or more objects to format. - - - Formats and writes a log message at the specified log level. - The to write to. - Entry will be written on this level. - The exception to log. - Format string of the log message. - An object array that contains zero or more objects to format. - - - Formats and writes a log message at the specified log level. - The to write to. - Entry will be written on this level. - Format string of the log message. - An object array that contains zero or more objects to format. - - - Formats and writes a critical log message. - The to write to. - The event id associated with the log. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a critical log message. - The to write to. - The event id associated with the log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a critical log message. - The to write to. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a critical log message. - The to write to. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a debug log message. - The to write to. - The event id associated with the log. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a debug log message. - The to write to. - The event id associated with the log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a debug log message. - The to write to. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a debug log message. - The to write to. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes an error log message. - The to write to. - The event id associated with the log. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes an error log message. - The to write to. - The event id associated with the log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes an error log message. - The to write to. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes an error log message. - The to write to. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes an informational log message. - The to write to. - The event id associated with the log. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes an informational log message. - The to write to. - The event id associated with the log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes an informational log message. - The to write to. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes an informational log message. - The to write to. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a trace log message. - The to write to. - The event id associated with the log. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a trace log message. - The to write to. - The event id associated with the log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a trace log message. - The to write to. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a trace log message. - The to write to. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a warning log message. - The to write to. - The event id associated with the log. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a warning log message. - The to write to. - The event id associated with the log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a warning log message. - The to write to. - The exception to log. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Formats and writes a warning log message. - The to write to. - Format string of the log message in message template format. Example: "User {User} logged in from {Address}" - An object array that contains zero or more objects to format. - - - Default implementation of - - - Creates a new . - - - Executes callback for each currently active scope objects in order of creation. - All callbacks are guaranteed to be called inline from this method. - - - - - - Adds scope object to the list. - - The token that removes scope on dispose. - - - ILoggerFactory extension methods for common scenarios. - - - Creates a new instance using the full name of the given . - The factory. - The type. - - - Creates a new instance using the full name of the given type. - The factory. - The type. - The that was created. - - - Creates delegates which can be later cached to log messages in a performant way. - - - Creates a delegate which can be invoked for logging a message. - The - The event id - The named format string - A delegate which when invoked creates a log message. - - - Creates a delegate which can be invoked for logging a message. - The - The event id - The named format string - The type of the first parameter passed to the named format string. - A delegate which when invoked creates a log message. - - - Creates a delegate which can be invoked for logging a message. - The - The event id - The named format string - The type of the first parameter passed to the named format string. - The type of the second parameter passed to the named format string. - A delegate which when invoked creates a log message. - - - Creates a delegate which can be invoked for logging a message. - The - The event id - The named format string - The type of the first parameter passed to the named format string. - The type of the second parameter passed to the named format string. - The type of the third parameter passed to the named format string. - A delegate which when invoked creates a log message. - - - Creates a delegate which can be invoked for logging a message. - The - The event id - The named format string - The type of the first parameter passed to the named format string. - The type of the second parameter passed to the named format string. - The type of the third parameter passed to the named format string. - The type of the fourth parameter passed to the named format string. - A delegate which when invoked creates a log message. - - - Creates a delegate which can be invoked for logging a message. - The - The event id - The named format string - The type of the first parameter passed to the named format string. - The type of the second parameter passed to the named format string. - The type of the third parameter passed to the named format string. - The type of the fourth parameter passed to the named format string. - The type of the fifth parameter passed to the named format string. - A delegate which when invoked creates a log message. - - - Creates a delegate which can be invoked for logging a message. - The - The event id - The named format string - The type of the first parameter passed to the named format string. - The type of the second parameter passed to the named format string. - The type of the third parameter passed to the named format string. - The type of the fourth parameter passed to the named format string. - The type of the fifth parameter passed to the named format string. - The type of the sixth parameter passed to the named format string. - A delegate which when invoked creates a log message. - - - Creates a delegate which can be invoked to create a log scope. - The named format string - A delegate which when invoked creates a log scope. - - - Creates a delegate which can be invoked to create a log scope. - The named format string - The type of the first parameter passed to the named format string. - A delegate which when invoked creates a log scope. - - - Creates a delegate which can be invoked to create a log scope. - The named format string - The type of the first parameter passed to the named format string. - The type of the second parameter passed to the named format string. - A delegate which when invoked creates a log scope. - - - Creates a delegate which can be invoked to create a log scope. - The named format string - The type of the first parameter passed to the named format string. - The type of the second parameter passed to the named format string. - The type of the third parameter passed to the named format string. - A delegate which when invoked creates a log scope. - - - - - - - - - - - - - - - - - - - - - - - - - - - Defines logging severity levels. - - - Logs that describe an unrecoverable application or system crash, or a catastrophic failure that requires - immediate attention. - - - Logs that are used for interactive investigation during development. These logs should primarily contain - information useful for debugging and have no long-term value. - - - Logs that highlight when the current flow of execution is stopped due to a failure. These should indicate a - failure in the current activity, not an application-wide failure. - - - Logs that track the general flow of the application. These logs should have long-term value. - - - Not used for writing log messages. Specifies that a logging category should not write any messages. - - - Logs that contain the most detailed messages. These messages may contain sensitive application data. - These messages are disabled by default and should never be enabled in a production environment. - - - Logs that highlight an abnormal or unexpected event in the application flow, but do not otherwise cause the - application execution to stop. - - - \ No newline at end of file + + Microsoft.Extensions.Logging.Abstractions + + + + + Identifies a logging event. The primary identifier is the "Id" property, with the "Name" property providing a short description of this type of event. + + + + + Implicitly creates an EventId from the given . + + The to convert to an EventId. + + + + Checks if two specified instances have the same value. They are equal if they have the same Id. + + The first . + The second . + if the objects are equal. + + + + Checks if two specified instances have different values. + + The first . + The second . + if the objects are not equal. + + + + Initializes an instance of the struct. + + The numeric identifier for this event. + The name of this event. + + + + Gets the numeric identifier for this event. + + + + + Gets the name of this event. + + + + + + + + Indicates whether the current object is equal to another object of the same type. Two events are equal if they have the same id. + + An object to compare with this object. + if the current object is equal to the other parameter; otherwise, . + + + + + + + + + + LogValues to enable formatting options supported by . + This also enables using {NamedformatItem} in the format string. + + + + + Represents a storage of common scope data. + + + + + Executes callback for each currently active scope objects in order of creation. + All callbacks are guaranteed to be called inline from this method. + + The callback to be executed for every scope object + The state object to be passed into the callback + The type of state to accept. + + + + Adds scope object to the list + + The scope object + The token that removes scope on dispose. + + + + Represents a type used to perform logging. + + Aggregates most logging patterns to a single method. + + + + Writes a log entry. + + Entry will be written on this level. + Id of the event. + The entry to be written. Can be also an object. + The exception related to this entry. + Function to create a message of the and . + The type of the object to be written. + + + + Checks if the given is enabled. + + Level to be checked. + true if enabled. + + + + Begins a logical operation scope. + + The identifier for the scope. + The type of the state to begin scope for. + An that ends the logical operation scope on dispose. + + + + Represents a type used to configure the logging system and create instances of from + the registered s. + + + + + Creates a new instance. + + The category name for messages produced by the logger. + The . + + + + Adds an to the logging system. + + The . + + + + Represents a type that can create instances of . + + + + + Creates a new instance. + + The category name for messages produced by the logger. + The instance of that was created. + + + + A generic interface for logging where the category name is derived from the specified + type name. + Generally used to enable activation of a named from dependency injection. + + The type whose name is used for the logger category name. + + + + An interface for configuring logging providers. + + + + + Gets the where Logging services are configured. + + + + + Represents a that is able to consume external scope information. + + + + + Sets external scope information source for logger provider. + + The provider of scope data. + + + + Options for and its overloads + + + + + Gets or sets the flag to skip IsEnabled check for the logging method. + + + + + Holds the information for a single log entry. + + + + + Initializes an instance of the LogEntry struct. + + The log level. + The category name for the log. + The log event Id. + The state for which log is being written. + The log exception. + The formatter. + + + + Gets the LogLevel + + + + + Gets the log category + + + + + Gets the log EventId + + + + + Gets the TState + + + + + Gets the log exception + + + + + Gets the formatter + + + + + Minimalistic logger that does nothing. + + + + + Returns the shared instance of . + + + + + Initializes a new instance of the class. + + + + + + + + + + + + + + An used to create instance of + that logs nothing. + + + + + Creates a new instance. + + + + + Returns the shared instance of . + + + + + + This returns a instance which logs nothing. + + + + + + This method ignores the parameter and does nothing. + + + + + + + + Provider for the . + + + + + Returns an instance of . + + + + + + + + + + + Minimalistic logger that does nothing. + + + + + Returns an instance of . + + An instance of . + + + + + + + + This method ignores the parameters and does nothing. + + + + + + + + ILogger extension methods for common scenarios. + + + + + Formats and writes a debug log message. + + The to write to. + The event id associated with the log. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogDebug(0, exception, "Error while processing request from {Address}", address) + + + + Formats and writes a debug log message. + + The to write to. + The event id associated with the log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogDebug(0, "Processing request from {Address}", address) + + + + Formats and writes a debug log message. + + The to write to. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogDebug(exception, "Error while processing request from {Address}", address) + + + + Formats and writes a debug log message. + + The to write to. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogDebug("Processing request from {Address}", address) + + + + Formats and writes a trace log message. + + The to write to. + The event id associated with the log. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogTrace(0, exception, "Error while processing request from {Address}", address) + + + + Formats and writes a trace log message. + + The to write to. + The event id associated with the log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogTrace(0, "Processing request from {Address}", address) + + + + Formats and writes a trace log message. + + The to write to. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogTrace(exception, "Error while processing request from {Address}", address) + + + + Formats and writes a trace log message. + + The to write to. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogTrace("Processing request from {Address}", address) + + + + Formats and writes an informational log message. + + The to write to. + The event id associated with the log. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogInformation(0, exception, "Error while processing request from {Address}", address) + + + + Formats and writes an informational log message. + + The to write to. + The event id associated with the log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogInformation(0, "Processing request from {Address}", address) + + + + Formats and writes an informational log message. + + The to write to. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogInformation(exception, "Error while processing request from {Address}", address) + + + + Formats and writes an informational log message. + + The to write to. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogInformation("Processing request from {Address}", address) + + + + Formats and writes a warning log message. + + The to write to. + The event id associated with the log. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogWarning(0, exception, "Error while processing request from {Address}", address) + + + + Formats and writes a warning log message. + + The to write to. + The event id associated with the log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogWarning(0, "Processing request from {Address}", address) + + + + Formats and writes a warning log message. + + The to write to. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogWarning(exception, "Error while processing request from {Address}", address) + + + + Formats and writes a warning log message. + + The to write to. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogWarning("Processing request from {Address}", address) + + + + Formats and writes an error log message. + + The to write to. + The event id associated with the log. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogError(0, exception, "Error while processing request from {Address}", address) + + + + Formats and writes an error log message. + + The to write to. + The event id associated with the log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogError(0, "Processing request from {Address}", address) + + + + Formats and writes an error log message. + + The to write to. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogError(exception, "Error while processing request from {Address}", address) + + + + Formats and writes an error log message. + + The to write to. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogError("Processing request from {Address}", address) + + + + Formats and writes a critical log message. + + The to write to. + The event id associated with the log. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogCritical(0, exception, "Error while processing request from {Address}", address) + + + + Formats and writes a critical log message. + + The to write to. + The event id associated with the log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogCritical(0, "Processing request from {Address}", address) + + + + Formats and writes a critical log message. + + The to write to. + The exception to log. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogCritical(exception, "Error while processing request from {Address}", address) + + + + Formats and writes a critical log message. + + The to write to. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + logger.LogCritical("Processing request from {Address}", address) + + + + Formats and writes a log message at the specified log level. + + The to write to. + Entry will be written on this level. + Format string of the log message. + An object array that contains zero or more objects to format. + + + + Formats and writes a log message at the specified log level. + + The to write to. + Entry will be written on this level. + The event id associated with the log. + Format string of the log message. + An object array that contains zero or more objects to format. + + + + Formats and writes a log message at the specified log level. + + The to write to. + Entry will be written on this level. + The exception to log. + Format string of the log message. + An object array that contains zero or more objects to format. + + + + Formats and writes a log message at the specified log level. + + The to write to. + Entry will be written on this level. + The event id associated with the log. + The exception to log. + Format string of the log message. + An object array that contains zero or more objects to format. + + + + Formats the message and creates a scope. + + The to create the scope in. + Format string of the log message in message template format. Example: "User {User} logged in from {Address}" + An object array that contains zero or more objects to format. + A disposable scope object. Can be null. + + using(logger.BeginScope("Processing request from {Address}", address)) + { + } + + + + + Default implementation of + + + + + Creates a new . + + + + + + + + + + + ILoggerFactory extension methods for common scenarios. + + + + + Creates a new instance using the full name of the given type. + + The factory. + The type. + The that was created. + + + + Creates a new instance using the full name of the given . + + The factory. + The type. + The that was created. + + + + Creates delegates which can be later cached to log messages in a performant way. + + + + + Creates a delegate which can be invoked to create a log scope. + + The named format string + A delegate which when invoked creates a log scope. + + + + Creates a delegate which can be invoked to create a log scope. + + The type of the first parameter passed to the named format string. + The named format string + A delegate which when invoked creates a log scope. + + + + Creates a delegate which can be invoked to create a log scope. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The named format string + A delegate which when invoked creates a log scope. + + + + Creates a delegate which can be invoked to create a log scope. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The named format string + A delegate which when invoked creates a log scope. + + + + Creates a delegate which can be invoked to create a log scope. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The type of the fourth parameter passed to the named format string. + The named format string + A delegate which when invoked creates a log scope. + + + + Creates a delegate which can be invoked to create a log scope. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The type of the fourth parameter passed to the named format string. + The type of the fifth parameter passed to the named format string. + The named format string + A delegate which when invoked creates a log scope. + + + + Creates a delegate which can be invoked to create a log scope. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The type of the fourth parameter passed to the named format string. + The type of the fifth parameter passed to the named format string. + The type of the sixth parameter passed to the named format string. + The named format string + A delegate which when invoked creates a log scope. + + + + Creates a delegate which can be invoked for logging a message. + + The + The event id + The named format string + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The + The event id + The named format string + The + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The + The event id + The named format string + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The + The event id + The named format string + The + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The + The event id + The named format string + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The + The event id + The named format string + The + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The + The event id + The named format string + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The + The event id + The named format string + The + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The type of the fourth parameter passed to the named format string. + The + The event id + The named format string + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The type of the fourth parameter passed to the named format string. + The + The event id + The named format string + The + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The type of the fourth parameter passed to the named format string. + The type of the fifth parameter passed to the named format string. + The + The event id + The named format string + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The type of the fourth parameter passed to the named format string. + The type of the fifth parameter passed to the named format string. + The + The event id + The named format string + The + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The type of the fourth parameter passed to the named format string. + The type of the fifth parameter passed to the named format string. + The type of the sixth parameter passed to the named format string. + The + The event id + The named format string + A delegate which when invoked creates a log message. + + + + Creates a delegate which can be invoked for logging a message. + + The type of the first parameter passed to the named format string. + The type of the second parameter passed to the named format string. + The type of the third parameter passed to the named format string. + The type of the fourth parameter passed to the named format string. + The type of the fifth parameter passed to the named format string. + The type of the sixth parameter passed to the named format string. + The + The event id + The named format string + The + A delegate which when invoked creates a log message. + + + + Provides information to guide the production of a strongly-typed logging method. + + + The method this attribute is applied to: + - Must be a partial method. + - Must return void. + - Must not be generic. + - Must have an as one of its parameters. + - Must have a as one of its parameters. + - None of the parameters can be generic. + + + + + + + + Initializes a new instance of the class + which is used to guide the production of a strongly-typed logging method. + + + + + Initializes a new instance of the class + which is used to guide the production of a strongly-typed logging method. + + The log event Id. + The log level. + Format string of the log message. + + + + Initializes a new instance of the class + which is used to guide the production of a strongly-typed logging method. + + The log level. + Format string of the log message. + + + + Initializes a new instance of the class + which is used to guide the production of a strongly-typed logging method. + + The log level. + + + + Initializes a new instance of the class + which is used to guide the production of a strongly-typed logging method. + + Format string of the log message. + + + + Gets the logging event id for the logging method. + + + + + Gets or sets the logging event name for the logging method. + + + This will equal the method name if not specified. + + + + + Gets the logging level for the logging method. + + + + + Gets the message text for the logging method. + + + + + Gets the flag to skip IsEnabled check for the logging method. + + + + + Delegates to a new instance using the full name of the given type, created by the + provided . + + The type. + + + + Creates a new . + + The factory. + + + + + + + + + + + + + Defines logging severity levels. + + + + + Logs that contain the most detailed messages. These messages may contain sensitive application data. + These messages are disabled by default and should never be enabled in a production environment. + + + + + Logs that are used for interactive investigation during development. These logs should primarily contain + information useful for debugging and have no long-term value. + + + + + Logs that track the general flow of the application. These logs should have long-term value. + + + + + Logs that highlight an abnormal or unexpected event in the application flow, but do not otherwise cause the + application execution to stop. + + + + + Logs that highlight when the current flow of execution is stopped due to a failure. These should indicate a + failure in the current activity, not an application-wide failure. + + + + + Logs that describe an unrecoverable application or system crash, or a catastrophic failure that requires + immediate attention. + + + + + Not used for writing log messages. Specifies that a logging category should not write any messages. + + + + + Formatter to convert the named format items like {NamedformatItem} to format. + + + + + Scope provider that does nothing. + + + + + Returns a cached instance of . + + + + + + + + + + + An empty scope without any logic + + + + + + + + Pretty print a type name. + + The . + true to print a fully qualified name. + true to include generic parameter names. + true to include generic parameters. + Character to use as a delimiter in nested type names + The pretty printed type name. + + + + Get a pinnable reference to the builder. + Does not ensure there is a null char after + This overload is pattern matched in the C# 7.3+ compiler so you can omit + the explicit method call, and write eg "fixed (char* c = builder)" + + + + + Get a pinnable reference to the builder. + + Ensures that the builder has a null char after + + + Returns the underlying storage of the builder. + + + + Returns a span around the contents of the builder. + + Ensures that the builder has a null char after + + + + Resize the internal buffer either by doubling current buffer size or + by adding to + whichever is greater. + + + Number of chars requested beyond current position. + + + + Throws an if is null. + The reference type argument to validate as non-null. + The name of the parameter with which corresponds. + + + + Throws either an or an + if the specified string is or whitespace respectively. + + String to be checked for or whitespace. + The name of the parameter being checked. + The original value of . + + + + Attribute used to indicate a source generator should create a function for marshalling + arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time. + + + This attribute is meaningless if the source generator associated with it is not enabled. + The current built-in source generator only supports C# and only supplies an implementation when + applied to static, partial, non-generic methods. + + + + + Initializes a new instance of the . + + Name of the library containing the import. + + + + Gets the name of the library containing the import. + + + + + Gets or sets the name of the entry point to be called. + + + + + Gets or sets how to marshal string arguments to the method. + + + If this field is set to a value other than , + must not be specified. + + + + + Gets or sets the used to control how string arguments to the method are marshalled. + + + If this field is specified, must not be specified + or must be set to . + + + + + Gets or sets whether the callee sets an error (SetLastError on Windows or errno + on other platforms) before returning from the attributed method. + + + + + Specifies how strings should be marshalled for generated p/invokes + + + + + Indicates the user is suppling a specific marshaller in . + + + + + Use the platform-provided UTF-8 marshaller. + + + + + Use the platform-provided UTF-16 marshaller. + + + + The format string '{0}' does not have the expected number of named parameters. Expected {1} parameter(s) but found {2} parameter(s). + + + Specifies that null is allowed as an input even if the corresponding type disallows it. + + + Specifies that null is disallowed as an input even if the corresponding type allows it. + + + Specifies that an output may be null even if the corresponding type disallows it. + + + Specifies that an output will not be null even if the corresponding type allows it. Specifies that an input argument was not null when the call returns. + + + Specifies that when a method returns , the parameter may be null even if the corresponding type disallows it. + + + Initializes the attribute with the specified return value condition. + + The return value condition. If the method returns this value, the associated parameter may be null. + + + + Gets the return value condition. + + + 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 the output will be non-null if the named parameter is non-null. + + + Initializes the attribute with the associated parameter name. + + The associated parameter name. The output will be non-null if the argument to the parameter specified is non-null. + + + + Gets the associated parameter name. + + + Applied to a method that will never return under any circumstance. + + + Specifies that the method will not return if the associated Boolean parameter is passed the specified value. + + + Initializes the attribute with the specified parameter value. + + 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. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values. + + + Initializes the attribute with a field or property member. + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the list of field and property members. + + The list of field and property members that are promised to be not-null. + + + + Gets field or property member names. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values when returning with the specified return value condition. + + + Initializes the attribute with the specified return value condition and a field or property member. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the specified return value condition and list of field and property members. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The list of field and property members that are promised to be not-null. + + + + Gets the return value condition. + + + Gets field or property member names. + + + diff --git a/Bin/Microsoft.Extensions.Logging.dll b/Bin/Microsoft.Extensions.Logging.dll index 611afff45..77fe4f93e 100644 Binary files a/Bin/Microsoft.Extensions.Logging.dll and b/Bin/Microsoft.Extensions.Logging.dll differ diff --git a/Bin/Microsoft.Extensions.Logging.dll.refresh b/Bin/Microsoft.Extensions.Logging.dll.refresh new file mode 100644 index 000000000..b27ca86f2 Binary files /dev/null and b/Bin/Microsoft.Extensions.Logging.dll.refresh differ diff --git a/Bin/Microsoft.Extensions.Logging.xml b/Bin/Microsoft.Extensions.Logging.xml index db70f157c..54607f427 100644 --- a/Bin/Microsoft.Extensions.Logging.xml +++ b/Bin/Microsoft.Extensions.Logging.xml @@ -1,287 +1,672 @@ - + - - Microsoft.Extensions.Logging - - - - Extension methods for setting up logging services in an . - - - Adds logging services to the specified . - The to add services to. - The so that additional calls can be chained. - - - Adds logging services to the specified . - The to add services to. - The configuration delegate. - The so that additional calls can be chained. - - - - - - - - - - Extension methods for setting up logging services in an . - - - Adds a log filter to the factory. - The to add the filter to. - The filter to be added. - The so that additional calls can be chained. - - - Adds a log filter to the factory. - The to add the filter to. - The filter to be added. - The so that additional calls can be chained. - - - Adds a log filter to the factory. - The to add the filter to. - The filter to be added. - The so that additional calls can be chained. - - - Adds a log filter to the factory. - The to add the filter to. - The category to filter. - The level to filter. - The so that additional calls can be chained. - - - Adds a log filter to the factory. - The to add the filter to. - The category to filter. - The filter function to apply. - The so that additional calls can be chained. - - - Adds a log filter to the factory. - The to add the filter to. - The filter function to apply. - The so that additional calls can be chained. - - - Adds a log filter to the factory. - The to add the filter to. - The filter function to apply. - The so that additional calls can be chained. - - - Adds a log filter to the factory. - The to add the filter to. - The filter function to apply. - The so that additional calls can be chained. - - - Adds a log filter to the factory. - The to add the filter to. - The category to filter. - The level to filter. - The so that additional calls can be chained. - - - Adds a log filter to the factory. - The to add the filter to. - The category to filter. - The filter function to apply. - The so that additional calls can be chained. - - - Adds a log filter for the given . - The to add the filter to. - The filter to be added. - The which this filter will be added for. - The so that additional calls can be chained. - - - Adds a log filter for the given . - The to add the filter to. - The filter to be added. - The which this filter will be added for. - The so that additional calls can be chained. - - - Adds a log filter for the given . - The to add the filter to. - The category to filter. - The level to filter. - The which this filter will be added for. - The so that additional calls can be chained. - - - Adds a log filter for the given . - The to add the filter to. - The category to filter. - The filter function to apply. - The which this filter will be added for. - The so that additional calls can be chained. - - - Adds a log filter for the given . - The to add the filter to. - The filter function to apply. - The which this filter will be added for. - The so that additional calls can be chained. - - - Adds a log filter for the given . - The to add the filter to. - The filter function to apply. - The which this filter will be added for. - The so that additional calls can be chained. - - - Adds a log filter for the given . - The to add the filter to. - The category to filter. - The level to filter. - The which this filter will be added for. - The so that additional calls can be chained. - - - Adds a log filter for the given . - The to add the filter to. - The category to filter. - The filter function to apply. - The which this filter will be added for. - The so that additional calls can be chained. - - - An interface for configuring logging providers. - - - Gets the where Logging services are configured. - - - Produces instances of classes based on the given providers. - - - Creates a new instance. - - - Creates a new instance. - The providers to use in producing instances. - - - Creates a new instance. - The providers to use in producing instances. - The filter options to use. - - - Creates a new instance. - The providers to use in producing instances. - The filter option to use. - - - - - - - - Adds the given provider to those used in creating instances. - The to add. - - - Check if the factory has been disposed. - - when as been called - - - Creates new instance of configured using provided delegate. - A delegate to configure the . - The that was created. - - - Creates an with the given . - The category name for messages produced by the logger. - The that was created. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - - - - The options for a LoggerFilter. - - - Creates a new instance. - - - Gets or sets value indicating whether logging scopes are being captured. Defaults to - - - Gets or sets the minimum level of log messages if none of the rules match. - - - Gets the collection of used for filtering log messages. - - - Defines a rule used to filter log messages. - - - Creates a new instance. - The provider name to use in this filter rule. - The category name to use in this filter rule. - The to use in this filter rule. - The filter to apply. - - - - Gets the logger category this rule applies to. - - - Gets the filter delegate that would be applied to messages that passed the . - - - Gets the minimum of messages. - - - Gets the logger provider type or alias this rule applies to. - - - Provides extension methods for setting up logging services in an . - - - Configures logger filter options from an instance of . - The logging builder to configure logger filter options for. - The filter options to add. - The logging builder with filter options configured. - - - Adds the given to the so that calls can be chained. - The logging builder to add the to. - The logger provider to add to the . - A logging builder that you can chain additional calls to. - - - Removes all logger providers from . - The logging builder to remove logging providers from. - The logging builder with logger providers removed. - - - - Sets a minimum requirement for log messages to be logged. - The logging builder to set the minimum level on. - One of the enumeration values to set as the minimum logging severity level. - The logging builder with minimum log level set. - - - Defines alias for implementation to be used in filtering rules. - - - Creates a new instance. - The alias to set. - - - The alias of the provider. - - - \ No newline at end of file + + Microsoft.Extensions.Logging + + + + + Flags to indicate which trace context parts should be included with the logging scopes. + + + + + None of the trace context part will be included in the logging. + + + + + Span Id will be included in the logging. + + + + + Trace Id will be included in the logging. + + + + + Parent Id will be included in the logging. + + + + + Trace State will be included in the logging. + + + + + Trace flags will be included in the logging. + + + + + Tags will be included in the logging. + + + + + Items of baggage will be included in the logging. + + + + + Extension methods for setting up logging services in an . + + + + + Adds a log filter to the factory. + + The to add the filter to. + The filter to be added. + The so that additional calls can be chained. + + + + Adds a log filter to the factory. + + The to add the filter to. + The filter to be added. + The so that additional calls can be chained. + + + + Adds a log filter for the given . + + The to add the filter to. + The filter to be added. + The which this filter will be added for. + The so that additional calls can be chained. + + + + Adds a log filter to the factory. + + The to add the filter to. + The filter to be added. + The so that additional calls can be chained. + + + + Adds a log filter for the given . + + The to add the filter to. + The filter to be added. + The which this filter will be added for. + The so that additional calls can be chained. + + + + Adds a log filter to the factory. + + The to add the filter to. + The category to filter. + The level to filter. + The so that additional calls can be chained. + + + + Adds a log filter for the given . + + The to add the filter to. + The category to filter. + The level to filter. + The which this filter will be added for. + The so that additional calls can be chained. + + + + Adds a log filter to the factory. + + The to add the filter to. + The category to filter. + The filter function to apply. + The so that additional calls can be chained. + + + + Adds a log filter for the given . + + The to add the filter to. + The category to filter. + The filter function to apply. + The which this filter will be added for. + The so that additional calls can be chained. + + + + Adds a log filter to the factory. + + The to add the filter to. + The filter function to apply. + The so that additional calls can be chained. + + + + Adds a log filter to the factory. + + The to add the filter to. + The filter function to apply. + The so that additional calls can be chained. + + + + Adds a log filter for the given . + + The to add the filter to. + The filter function to apply. + The which this filter will be added for. + The so that additional calls can be chained. + + + + Adds a log filter to the factory. + + The to add the filter to. + The filter function to apply. + The so that additional calls can be chained. + + + + Adds a log filter for the given . + + The to add the filter to. + The filter function to apply. + The which this filter will be added for. + The so that additional calls can be chained. + + + + Adds a log filter to the factory. + + The to add the filter to. + The category to filter. + The level to filter. + The so that additional calls can be chained. + + + + Adds a log filter for the given . + + The to add the filter to. + The category to filter. + The level to filter. + The which this filter will be added for. + The so that additional calls can be chained. + + + + Adds a log filter to the factory. + + The to add the filter to. + The category to filter. + The filter function to apply. + The so that additional calls can be chained. + + + + Adds a log filter for the given . + + The to add the filter to. + The category to filter. + The filter function to apply. + The which this filter will be added for. + The so that additional calls can be chained. + + + + Produces instances of classes based on the given providers. + + + + + Creates a new instance. + + + + + Creates a new instance. + + The providers to use in producing instances. + + + + Creates a new instance. + + The providers to use in producing instances. + The filter options to use. + + + + Creates a new instance. + + The providers to use in producing instances. + The filter option to use. + + + + Creates a new instance. + + The providers to use in producing instances. + The filter option to use. + The . + + + + Creates a new instance. + + The providers to use in producing instances. + The filter option to use. + The . + The . + + + + Creates new instance of configured using provided delegate. + + A delegate to configure the . + The that was created. + + + + Creates an with the given . + + The category name for messages produced by the logger. + The that was created. + + + + Adds the given provider to those used in creating instances. + + The to add. + + + + Check if the factory has been disposed. + + True when as been called + + + + + + + The options for a LoggerFactory. + + + + + Creates a new instance. + + + + + Gets or sets value to indicate which parts of the tracing context information should be included with the logging scopes. + + + + + Default implementation of + + + + + The options for a LoggerFilter. + + + + + Creates a new instance. + + + + + Gets or sets value indicating whether logging scopes are being captured. Defaults to true + + + + + Gets or sets the minimum level of log messages if none of the rules match. + + + + + Gets the collection of used for filtering log messages. + + + + + Defines a rule used to filter log messages + + + + + Creates a new instance. + + The provider name to use in this filter rule. + The category name to use in this filter rule. + The to use in this filter rule. + The filter to apply. + + + + Gets the logger provider type or alias this rule applies to. + + + + + Gets the logger category this rule applies to. + + + + + Gets the minimum of messages. + + + + + Gets the filter delegate that would be applied to messages that passed the . + + + + + + + + Extension methods for setting up logging services in an . + + + + + Sets a minimum requirement for log messages to be logged. + + The to set the minimum level on. + The to set as the minimum. + The so that additional calls can be chained. + + + + Adds the given to the + + The to add the to. + The to add to the . + The so that additional calls can be chained. + + + + Removes all s from . + + The to remove s from. + The so that additional calls can be chained. + + + + Configure the with the . + + The to be configured with + The action used to configure the logger factory + The so that additional calls can be chained. + + + + Defines alias for implementation to be used in filtering rules. + + + + + Creates a new instance. + + The alias to set. + + + + The alias of the provider. + + + + + Scope provider that does nothing. + + + + + Returns a cached instance of . + + + + + + + + + + + An empty scope without any logic + + + + + + + + Extension methods for setting up logging services in an . + + + + + Adds logging services to the specified . + + The to add services to. + The so that additional calls can be chained. + + + + Adds logging services to the specified . + + The to add services to. + The configuration delegate. + The so that additional calls can be chained. + + + Throws an if is null. + The reference type argument to validate as non-null. + The name of the parameter with which corresponds. + + + + Throws either an or an + if the specified string is or whitespace respectively. + + String to be checked for or whitespace. + The name of the parameter being checked. + The original value of . + + + + Attribute used to indicate a source generator should create a function for marshalling + arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time. + + + This attribute is meaningless if the source generator associated with it is not enabled. + The current built-in source generator only supports C# and only supplies an implementation when + applied to static, partial, non-generic methods. + + + + + Initializes a new instance of the . + + Name of the library containing the import. + + + + Gets the name of the library containing the import. + + + + + Gets or sets the name of the entry point to be called. + + + + + Gets or sets how to marshal string arguments to the method. + + + If this field is set to a value other than , + must not be specified. + + + + + Gets or sets the used to control how string arguments to the method are marshalled. + + + If this field is specified, must not be specified + or must be set to . + + + + + Gets or sets whether the callee sets an error (SetLastError on Windows or errno + on other platforms) before returning from the attributed method. + + + + + Specifies how strings should be marshalled for generated p/invokes + + + + + Indicates the user is suppling a specific marshaller in . + + + + + Use the platform-provided UTF-8 marshaller. + + + + + Use the platform-provided UTF-16 marshaller. + + + + {0} is invalid ActivityTrackingOptions value. + + + Only one wildcard character is allowed in category name. + + + Specifies that null is allowed as an input even if the corresponding type disallows it. + + + Specifies that null is disallowed as an input even if the corresponding type allows it. + + + Specifies that an output may be null even if the corresponding type disallows it. + + + Specifies that an output will not be null even if the corresponding type allows it. Specifies that an input argument was not null when the call returns. + + + Specifies that when a method returns , the parameter may be null even if the corresponding type disallows it. + + + Initializes the attribute with the specified return value condition. + + The return value condition. If the method returns this value, the associated parameter may be null. + + + + Gets the return value condition. + + + 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 the output will be non-null if the named parameter is non-null. + + + Initializes the attribute with the associated parameter name. + + The associated parameter name. The output will be non-null if the argument to the parameter specified is non-null. + + + + Gets the associated parameter name. + + + Applied to a method that will never return under any circumstance. + + + Specifies that the method will not return if the associated Boolean parameter is passed the specified value. + + + Initializes the attribute with the specified parameter value. + + 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. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values. + + + Initializes the attribute with a field or property member. + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the list of field and property members. + + The list of field and property members that are promised to be not-null. + + + + Gets field or property member names. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values when returning with the specified return value condition. + + + Initializes the attribute with the specified return value condition and a field or property member. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the specified return value condition and list of field and property members. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The list of field and property members that are promised to be not-null. + + + + Gets the return value condition. + + + Gets field or property member names. + + + diff --git a/Bin/Microsoft.Extensions.Options.dll b/Bin/Microsoft.Extensions.Options.dll index 9470a4676..4391fb0b2 100644 Binary files a/Bin/Microsoft.Extensions.Options.dll and b/Bin/Microsoft.Extensions.Options.dll differ diff --git a/Bin/Microsoft.Extensions.Options.dll.refresh b/Bin/Microsoft.Extensions.Options.dll.refresh new file mode 100644 index 000000000..0b4564968 Binary files /dev/null and b/Bin/Microsoft.Extensions.Options.dll.refresh differ diff --git a/Bin/Microsoft.Extensions.Options.xml b/Bin/Microsoft.Extensions.Options.xml index e0295cbe2..11b44a2f8 100644 --- a/Bin/Microsoft.Extensions.Options.xml +++ b/Bin/Microsoft.Extensions.Options.xml @@ -1,1254 +1,2404 @@ - + - - Microsoft.Extensions.Options - - - - Extension methods for adding options services to the DI container. - - - Adds services required for using options. - The to add the services to. - The so that additional calls can be chained. - - - Gets an options builder that forwards Configure calls for the same named to the underlying service collection. - The to add the services to. - The options type to be configured. - The so that configure calls can be chained in it. - - - Gets an options builder that forwards Configure calls for the same named to the underlying service collection. - The to add the services to. - The name of the options instance. - The options type to be configured. - The so that Configure calls can be chained in it. - - - Registers an action used to configure a particular type of options. These are run before . - The to add the services to. - The action used to configure the options. - The options type to be configured. - The so that additional calls can be chained. - - - Registers an action used to configure a particular type of options. These are run before . - The to add the services to. - The name of the options instance. - The action used to configure the options. - The options type to be configured. - The so that additional calls can be chained. - - - Registers an action used to configure all instances of a particular type of options. - The to add the services to. - The action used to configure the options. - The options type to be configured. - The so that additional calls can be chained. - - - Registers an object that will have all of its I[Post]ConfigureOptions registered. - The to add the services to. - The instance that will configure options. - The so that additional calls can be chained. - - - Registers a type that will have all of its I[Post]ConfigureOptions registered. - The to add the services to. - The type that will configure options. - The so that additional calls can be chained. - - - Registers a type that will have all of its I[Post]ConfigureOptions registered. - The to add the services to. - The type that will configure options. - The so that additional calls can be chained. - - - Registers an action used to initialize a particular type of options. These are run after . - The to add the services to. - The action used to configure the options. - The options type to be configured. - The so that additional calls can be chained. - - - Registers an action used to configure a particular type of options. These are run after . - The to add the services to. - The name of the options instance. - The action used to configure the options. - The options type to be configure. - The so that additional calls can be chained. - - - Registers an action used to post configure all instances of a particular type of options. These are run after . - The to add the services to. - The action used to configure the options. - The options type to be configured. - The so that additional calls can be chained. - - - Implementation of . - Options type being configured. - - - Constructor. - The name of the options. - The action to register. - - - Invoked to configure a instance with the . - The options instance to configure. - - - Invokes the registered configure if the matches. - The name of the options instance being configured. - The options instance to configure. - - - The configuration action. - - - The options name. - - - Implementation of . - Options type being configured. - Dependency type. - - - Constructor. - The name of the options. - A dependency. - The action to register. - - - Invoked to configure a instance with the . - The options instance to configure. - - - Invokes the registered configure if the matches. - The name of the options instance being configured. - The options instance to configure. - - - The configuration action. - - - The dependency. - - - The options name. - - - Implementation of . - Options type being configured. - First dependency type. - Second dependency type. - - - Constructor. - The name of the options. - A dependency. - A second dependency. - The action to register. - - - Invoked to configure a instance with the . - The options instance to configure. - - - Invokes the registered configure if the matches. - The name of the options instance being configured. - The options instance to configure. - - - The configuration action. - - - The first dependency. - - - The second dependency. - - - The options name. - - - Implementation of . - Options type being configured. - First dependency type. - Second dependency type. - Third dependency type. - - - Constructor. - The name of the options. - A dependency. - A second dependency. - A third dependency. - The action to register. - - - Invoked to configure a instance with the . - The options instance to configure. - - - Invokes the registered configure if the matches. - The name of the options instance being configured. - The options instance to configure. - - - The configuration action. - - - The first dependency. - - - The second dependency. - - - The third dependency. - - - The options name. - - - Implementation of . - Options type being configured. - First dependency type. - Second dependency type. - Third dependency type. - Fourth dependency type. - - - Constructor. - The name of the options. - A dependency. - A second dependency. - A third dependency. - A fourth dependency. - The action to register. - - - Invoked to configure a instance with the . - The options instance to configure. - - - Invokes the registered configure if the matches. - The name of the options instance being configured. - The options instance to configure. - - - The configuration action. - - - The first dependency. - - - The second dependency. - - - The third dependency. - - - The fourth dependency. - - - The options name. - - - Implementation of . - Options type being configured. - First dependency type. - Second dependency type. - Third dependency type. - Fourth dependency type. - Fifth dependency type. - - - Constructor. - The name of the options. - A dependency. - A second dependency. - A third dependency. - A fourth dependency. - A fifth dependency. - The action to register. - - - Invoked to configure a instance with the . - The options instance to configure. - - - Invokes the registered configure if the matches. - The name of the options instance being configured. - The options instance to configure. - - - The configuration action. - - - The first dependency. - - - The second dependency. - - - The third dependency. - - - The fourth dependency. - - - The fifth dependency. - - - The options name. - - - Implementation of . - Options type being configured. - - - Constructor. - The action to register. - - - Invokes the registered configure . - The options instance to configure. - - - The configuration action. - - - Represents something that configures the type. - - - - Invoked to configure a instance. - The name of the options instance being configured. - The options instance to configure. - - - Represents something that configures the type. - Note: These are run before all . - - - - Invoked to configure a instance. - The options instance to configure. - - - Used to retrieve configured instances. - The type of options being requested. - - - Gets the default configured instance. - - - Used to fetch used for tracking options changes. - Options type. - - - Returns a which can be used to register a change notification callback. - Change token. - - - The name of the option instance being changed. - - - Used to create instances. - The type of options being requested. - - - Returns a configured instance with the given name. - - - - Used for notifications when instances change. - The options type. - - - Returns a configured instance with the given name. - - - - Registers a listener to be called whenever a named changes. - The action to be invoked when has changed. - An which should be disposed to stop listening for changes. - - - Returns the current instance with the . - - - Used by to cache instances. - The type of options being requested. - - - Clears all options instances from the cache. - - - Gets a named options instance, or adds a new instance created with . - The name of the options instance. - The func used to create the new instance. - The options instance. - - - Tries to adds a new option to the cache, will return false if the name already exists. - The name of the options instance. - The options instance. - Whether anything was added. - - - Try to remove an options instance. - The name of the options instance. - Whether anything was removed. - - - Used to access the value of for the lifetime of a request. - Options type. - - - Returns a configured instance with the given name. - - - - Represents something that configures the type. - Note: These are run after all . - Options type being configured. - - - Invoked to configure a instance. - The name of the options instance being configured. - The options instance to configured. - - - Interface used to validate options. - The options type to validate. - - - Validates a specific named options instance (or all when name is null). - The name of the options instance being validated. - The options instance. - The result. - - - Helper class. - - - The default name used for options instances: "". - - - Creates a wrapper around an instance of to return itself as an . - Options object. - Options type. - Wrapped options object. - - - Used to configure instances. - The type of options being requested. - - - Constructor. - The for the options being configured. - The default name of the instance, if null is used. - - - Registers an action used to configure a particular type of options. These are run before all . - The action used to configure the options. - The current . - - - Registers an action used to configure a particular type of options. These are run before all . - The action used to configure the options. - A dependency used by the action. - The current . - - - Registers an action used to configure a particular type of options. These are run before all . - The action used to configure the options. - The first dependency used by the action. - The second dependency used by the action. - The current . - - - Registers an action used to configure a particular type of options. These are run before all . - The action used to configure the options. - The first dependency used by the action. - The second dependency used by the action. - The third dependency used by the action. - The current . - - - Registers an action used to configure a particular type of options. These are run before all . - The action used to configure the options. - The first dependency used by the action. - The second dependency used by the action. - The third dependency used by the action. - The fourth dependency used by the action. - The current . - - - Registers an action used to configure a particular type of options. These are run before all . - The action used to configure the options. - The first dependency used by the action. - The second dependency used by the action. - The third dependency used by the action. - The fourth dependency used by the action. - The fifth dependency used by the action. - The current . - - - Registers an action used to configure a particular type of options. These are run after all . - The action used to configure the options. - - - Registers an action used to post configure a particular type of options. These are run after all . - The action used to configure the options. - The dependency used by the action. - The current . - - - Registers an action used to post configure a particular type of options. These are run after all . - The action used to configure the options. - The first dependency used by the action. - The second dependency used by the action. - The current . - - - Registers an action used to post configure a particular type of options. These are run after all . - The action used to configure the options. - The first dependency used by the action. - The second dependency used by the action. - The third dependency used by the action. - The current . - - - Registers an action used to post configure a particular type of options. These are run after all . - The action used to configure the options. - The first dependency used by the action. - The second dependency used by the action. - The third dependency used by the action. - The fourth dependency used by the action. - The current . - - - Registers an action used to post configure a particular type of options. These are run after all . - The action used to configure the options. - The first dependency used by the action. - The second dependency used by the action. - The third dependency used by the action. - The fourth dependency used by the action. - The fifth dependency used by the action. - The current . - - - Register a validation action for an options type using a default failure message. - The validation function. - The current . - - - Register a validation action for an options type. - The validation function. - The failure message to use when validation fails. - The current . - - - Register a validation action for an options type using a default failure message. - The validation function. - The dependency used by the validation function. - The current . - - - Register a validation action for an options type. - The validation function. - The failure message to use when validation fails. - The dependency used by the validation function. - The current . - - - Register a validation action for an options type using a default failure message. - The validation function. - The first dependency used by the validation function. - The second dependency used by the validation function. - The current . - - - Register a validation action for an options type. - The validation function. - The failure message to use when validation fails. - The first dependency used by the validation function. - The second dependency used by the validation function. - The current . - - - Register a validation action for an options type using a default failure message. - The validation function. - The first dependency used by the validation function. - The second dependency used by the validation function. - The third dependency used by the validation function. - The current . - - - Register a validation action for an options type. - The validation function. - The failure message to use when validation fails. - The first dependency used by the validation function. - The second dependency used by the validation function. - The third dependency used by the validation function. - The current . - - - Register a validation action for an options type using a default failure message. - The validation function. - The first dependency used by the validation function. - The second dependency used by the validation function. - The third dependency used by the validation function. - The fourth dependency used by the validation function. - The current . - - - Register a validation action for an options type. - The validation function. - The failure message to use when validation fails. - The first dependency used by the validation function. - The second dependency used by the validation function. - The third dependency used by the validation function. - The fourth dependency used by the validation function. - The current . - - - Register a validation action for an options type using a default failure message. - The validation function. - The first dependency used by the validation function. - The second dependency used by the validation function. - The third dependency used by the validation function. - The fourth dependency used by the validation function. - The fifth dependency used by the validation function. - The current . - - - Register a validation action for an options type. - The validation function. - The failure message to use when validation fails. - The first dependency used by the validation function. - The second dependency used by the validation function. - The third dependency used by the validation function. - The fourth dependency used by the validation function. - The fifth dependency used by the validation function. - The current . - - - The default name of the instance. - - - The for the options being configured. - - - Used to cache instances. - The type of options being requested. - - - - Clears all options instances from the cache. - - - Gets a named options instance, or adds a new instance created with . - The name of the options instance. - The func used to create the new instance. - The options instance. - - - Tries to adds a new option to the cache, will return false if the name already exists. - The name of the options instance. - The options instance. - Whether anything was added. - - - Try to remove an options instance. - The name of the options instance. - Whether anything was removed. - - - Implementation of . - The type of options being requested. - - - Initializes a new instance with the specified options configurations. - The configuration actions to run. - The initialization actions to run. - - - Initializes a new instance with the specified options configurations. - The configuration actions to run. - The initialization actions to run. - The validations to run. - - - Returns a configured instance with the given . - - - - - - - Implementation of and . - Options type. - - - Initializes a new instance with the specified options configurations. - The factory to use to create options. - - - Returns a configured instance with the given . - - - - The default configured instance, equivalent to Get(Options.DefaultName). - - - Implementation of . - Options type. - - - Constructor. - The factory to use to create options. - The sources used to listen for changes to the options instance. - The cache used to store options. - - - Removes all change registration subscriptions. - - - Returns a configured instance with the given . - - - - Registers a listener to be called whenever changes. - The action to be invoked when has changed. - An which should be disposed to stop listening for changes. - - - The present value of the options. - - - Extension methods for . - - - Registers a listener to be called whenever changes. - The IOptionsMonitor. - The action to be invoked when has changed. - - An which should be disposed to stop listening for changes. - - - Thrown when options validation fails. - - - Constructor. - The name of the options instance that failed. - The options type that failed. - The validation failure messages. - - - The validation failures. - - - The message is a semicolon separated list of the . - - - The name of the options instance that failed. - - - The type of the options that failed. - - - - wrapper that returns the options instance. - Options type. - - - Intializes the wrapper with the options instance to return. - The options instance to return. - - - The options instance. - - - Implementation of . - Options type being configured. - - - Creates a new instance of . - The name of the options. - The action to register. - - - Invokes the registered initialization if the matches. - The name of the action to invoke. - The options to use in initialization. - - - The initialization action. - - - The options name. - - - Implementation of . - Options type being configured. - Dependency type. - - - Constructor. - The name of the options. - A dependency. - The action to register. - - - Invoked to configure a instance using the . - The options instance to configured. - - - Invokes the registered initialization if the matches. - The name of the options instance being configured. - The options instance to configured. - - - The configuration action. - - - The dependency. - - - The options name. - - - Implementation of . - Options type being configured. - First dependency type. - Second dependency type. - - - Constructor. - The name of the options. - A dependency. - A second dependency. - The action to register. - - - Invoked to configure a instance using the . - The options instance to configured. - - - Invokes the registered initialization if the matches. - The name of the options instance being configured. - The options instance to configured. - - - The configuration action. - - - The first dependency. - - - The second dependency. - - - The options name. - - - Implementation of . - Options type being configured. - First dependency type. - Second dependency type. - Third dependency type. - - - Constructor. - The name of the options. - A dependency. - A second dependency. - A third dependency. - The action to register. - - - Invoked to configure a instance using the . - The options instance to configured. - - - Invokes the registered initialization if the matches. - The name of the options instance being configured. - The options instance to configured. - - - The configuration action. - - - The first dependency. - - - The second dependency. - - - The third dependency. - - - The options name. - - - Implementation of . - Options type being configured. - First dependency type. - Second dependency type. - Third dependency type. - Fourth dependency type. - - - Constructor. - The name of the options. - A dependency. - A second dependency. - A third dependency. - A fourth dependency. - The action to register. - - - Invoked to configure a instance using the . - The options instance to configured. - - - Invokes the registered initialization if the matches. - The name of the options instance being configured. - The options instance to configured. - - - The configuration action. - - - The first dependency. - - - The second dependency. - - - The third dependency. - - - The fourth dependency. - - - The options name. - - - Implementation of . - Options type being configured. - First dependency type. - Second dependency type. - Third dependency type. - Fourth dependency type. - Fifth dependency type. - - - Constructor. - The name of the options. - A dependency. - A second dependency. - A third dependency. - A fourth dependency. - A fifth dependency. - The action to register. - - - Invoked to configure a instance using the . - The options instance to configured. - - - Invokes the registered initialization if the matches. - The name of the options instance being configured. - The options instance to configured. - - - The configuration action. - - - The first dependency. - - - The second dependency. - - - The third dependency. - - - The fourth dependency. - - - The fifth dependency. - - - The options name. - - - Implementation of - The options type to validate. - - - Constructor. - Options name. - Validation function. - Validation failure message. - - - Validates a specific named options instance (or all when is null). - The name of the options instance being validated. - The options instance. - The result. - - - The error to return when validation fails. - - - The options name. - - - The validation function. - - - Implementation of - The options type to validate. - Dependency type. - - - Constructor. - Options name. - The dependency. - Validation function. - Validation failure message. - - - Validates a specific named options instance (or all when is null). - The name of the options instance being validated. - The options instance. - The result. - - - The dependency. - - - The error to return when validation fails. - - - The options name. - - - The validation function. - - - Implementation of - The options type to validate. - First dependency type. - Second dependency type. - - - Constructor. - Options name. - The first dependency. - The second dependency. - Validation function. - Validation failure message. - - - Validates a specific named options instance (or all when is null). - The name of the options instance being validated. - The options instance. - The result. - - - The first dependency. - - - The second dependency. - - - The error to return when validation fails. - - - The options name. - - - The validation function. - - - Implementation of - The options type to validate. - First dependency type. - Second dependency type. - Third dependency type. - - - Constructor. - Options name. - The first dependency. - The second dependency. - The third dependency. - Validation function. - Validation failure message. - - - Validates a specific named options instance (or all when is null). - The name of the options instance being validated. - The options instance. - The result. - - - The first dependency. - - - The second dependency. - - - The third dependency. - - - The error to return when validation fails. - - - The options name. - - - The validation function. - - - Implementation of - The options type to validate. - First dependency type. - Second dependency type. - Third dependency type. - Fourth dependency type. - - - Constructor. - Options name. - The first dependency. - The second dependency. - The third dependency. - The fourth dependency. - Validation function. - Validation failure message. - - - Validates a specific named options instance (or all when is null). - The name of the options instance being validated. - The options instance. - The result. - - - The first dependency. - - - The second dependency. - - - The third dependency. - - - The fourth dependency. - - - The error to return when validation fails. - - - The options name. - - - The validation function. - - - Implementation of - The options type to validate. - First dependency type. - Second dependency type. - Third dependency type. - Fourth dependency type. - Fifth dependency type. - - - Constructor. - Options name. - The first dependency. - The second dependency. - The third dependency. - The fourth dependency. - The fifth dependency. - Validation function. - Validation failure message. - - - Validates a specific named options instance (or all when is null). - The name of the options instance being validated. - The options instance. - The result. - - - The first dependency. - - - The second dependency. - - - The third dependency. - - - The fourth dependency. - - - The fifth dependency. - - - The error to return when validation fails. - - - The options name. - - - The validation function. - - - Represents the result of an options validation. - - - Result when validation was skipped due to name not matching. - - - Validation was successful. - - - - Returns a failure result. - The reasons for the failure. - The failure result. - - - Returns a failure result. - The reason for the failure. - The failure result. - - - True if validation failed. - - - Used to describe why validation failed. - - - Full list of failures (can be multiple). - - - True if validation was not run. - - - True if validation was successful. - - - \ No newline at end of file + + Microsoft.Extensions.Options + + + + + Implementation of . + + Options type being configured. + + + + Constructor. + + The name of the options. + The action to register. + + + + The options name. + + + + + The configuration action. + + + + + Invokes the registered configure if the matches. + + The name of the options instance being configured. + The options instance to configure. + + + + Invoked to configure a instance with the . + + The options instance to configure. + + + + Implementation of . + + Options type being configured. + Dependency type. + + + + Constructor. + + The name of the options. + A dependency. + The action to register. + + + + The options name. + + + + + The configuration action. + + + + + The dependency. + + + + + Invokes the registered configure if the matches. + + The name of the options instance being configured. + The options instance to configure. + + + + Invoked to configure a instance with the . + + The options instance to configure. + + + + Implementation of . + + Options type being configured. + First dependency type. + Second dependency type. + + + + Constructor. + + The name of the options. + A dependency. + A second dependency. + The action to register. + + + + The options name. + + + + + The configuration action. + + + + + The first dependency. + + + + + The second dependency. + + + + + Invokes the registered configure if the matches. + + The name of the options instance being configured. + The options instance to configure. + + + + Invoked to configure a instance with the . + + The options instance to configure. + + + + Implementation of . + + Options type being configured. + First dependency type. + Second dependency type. + Third dependency type. + + + + Constructor. + + The name of the options. + A dependency. + A second dependency. + A third dependency. + The action to register. + + + + The options name. + + + + + The configuration action. + + + + + The first dependency. + + + + + The second dependency. + + + + + The third dependency. + + + + + Invokes the registered configure if the matches. + + The name of the options instance being configured. + The options instance to configure. + + + + Invoked to configure a instance with the . + + The options instance to configure. + + + + Implementation of . + + Options type being configured. + First dependency type. + Second dependency type. + Third dependency type. + Fourth dependency type. + + + + Constructor. + + The name of the options. + A dependency. + A second dependency. + A third dependency. + A fourth dependency. + The action to register. + + + + The options name. + + + + + The configuration action. + + + + + The first dependency. + + + + + The second dependency. + + + + + The third dependency. + + + + + The fourth dependency. + + + + + Invokes the registered configure if the matches. + + The name of the options instance being configured. + The options instance to configure. + + + + Invoked to configure a instance with the . + + The options instance to configure. + + + + Implementation of . + + Options type being configured. + First dependency type. + Second dependency type. + Third dependency type. + Fourth dependency type. + Fifth dependency type. + + + + Constructor. + + The name of the options. + A dependency. + A second dependency. + A third dependency. + A fourth dependency. + A fifth dependency. + The action to register. + + + + The options name. + + + + + The configuration action. + + + + + The first dependency. + + + + + The second dependency. + + + + + The third dependency. + + + + + The fourth dependency. + + + + + The fifth dependency. + + + + + Invokes the registered configure if the matches. + + The name of the options instance being configured. + The options instance to configure. + + + + Invoked to configure a instance with the . + + The options instance to configure. + + + + Implementation of . + + Options type being configured. + + + + Constructor. + + The action to register. + + + + The configuration action. + + + + + Invokes the registered configure . + + The options instance to configure. + + + + Represents something that configures the type. + + The options type being configured. + + + + Invoked to configure a instance. + + The name of the options instance being configured. + The options instance to configure. + + + + Represents something that configures the type. + Note: These are run before all . + + The options type being configured. + + + + Invoked to configure a instance. + + The options instance to configure. + + + + Used to retrieve configured instances. + + The type of options being requested. + + + + The default configured instance + + + + + Used to fetch used for tracking options changes. + + The options type being changed. + + + + Returns a which can be used to register a change notification callback. + + Change token. + + + + The name of the option instance being changed. + + + + + Used to create instances. + + The type of options being requested. + + + + Returns a configured instance with the given . + + The name of the instance to create. + The created instance with thw given . + + + + Used for notifications when instances change. + + The options type. + + + + Returns the current instance with the . + + + + + Returns a configured instance with the given . + + The name of the instance, if a is used. + The instance that matches the given . + + + + Registers a listener to be called whenever a named changes. + + The action to be invoked when has changed. + An which should be disposed to stop listening for changes. + + + + Used by to cache instances. + + The type of options being requested. + + + + Gets a named options instance, or adds a new instance created with . + + The name of the options instance. + The func used to create the new instance. + The options instance. + + + + Tries to adds a new option to the cache, will return false if the name already exists. + + The name of the options instance. + The options instance. + Whether anything was added. + + + + Try to remove an options instance. + + The name of the options instance. + Whether anything was removed. + + + + Clears all options instances from the cache. + + + + + Used to access the value of for the lifetime of a request. + + Options type. + + + + Returns a configured instance with the given . + + The name of the instance, if is used. + The instance that matches the given . + + + + Represents something that configures the type. + Note: These are run after all . + + Options type being configured. + + + + Invoked to configure a instance. + + The name of the options instance being configured. + The options instance to configured. + + + + Interface used by hosts to validate options during startup. + Options are enabled to be validated during startup by calling . + + + + + Calls the validators. + + One or more return failed when validating. + + + + Interface used to validate options. + + The options type to validate. + + + + Validates a specific named options instance (or all when name is null). + + The name of the options instance being validated. + The options instance. + The result. + + + + Helper class. + + + + + The default name used for options instances: "". + + + + + Creates a wrapper around an instance of to return itself as an . + + Options type. + Options object. + Wrapped options object. + + + + Used to configure instances. + + The type of options being requested. + + + + The default name of the instance. + + + + + The for the options being configured. + + + + + Constructor. + + The for the options being configured. + The default name of the instance, if null is used. + + + + Registers an action used to configure a particular type of options. + Note: These are run before all . + + The action used to configure the options. + The current . + + + + Registers an action used to configure a particular type of options. + Note: These are run before all . + + A dependency used by the action. + The action used to configure the options. + The current . + + + + Registers an action used to configure a particular type of options. + Note: These are run before all . + + The first dependency used by the action. + The second dependency used by the action. + The action used to configure the options. + The current . + + + + Registers an action used to configure a particular type of options. + Note: These are run before all . + + The first dependency used by the action. + The second dependency used by the action. + The third dependency used by the action. + The action used to configure the options. + The current . + + + + Registers an action used to configure a particular type of options. + Note: These are run before all . + + The first dependency used by the action. + The second dependency used by the action. + The third dependency used by the action. + The fourth dependency used by the action. + The action used to configure the options. + The current . + + + + Registers an action used to configure a particular type of options. + Note: These are run before all . + + The first dependency used by the action. + The second dependency used by the action. + The third dependency used by the action. + The fourth dependency used by the action. + The fifth dependency used by the action. + The action used to configure the options. + The current . + + + + Registers an action used to configure a particular type of options. + Note: These are run after all . + + The action used to configure the options. + The current . + + + + Registers an action used to post configure a particular type of options. + Note: These are run after all . + + The dependency used by the action. + The action used to configure the options. + The current . + + + + Registers an action used to post configure a particular type of options. + Note: These are run after all . + + The first dependency used by the action. + The second dependency used by the action. + The action used to configure the options. + The current . + + + + Registers an action used to post configure a particular type of options. + Note: These are run after all . + + The first dependency used by the action. + The second dependency used by the action. + The third dependency used by the action. + The action used to configure the options. + The current . + + + + Registers an action used to post configure a particular type of options. + Note: These are run after all . + + The first dependency used by the action. + The second dependency used by the action. + The third dependency used by the action. + The fourth dependency used by the action. + The action used to configure the options. + The current . + + + + Registers an action used to post configure a particular type of options. + Note: These are run after all . + + The first dependency used by the action. + The second dependency used by the action. + The third dependency used by the action. + The fourth dependency used by the action. + The fifth dependency used by the action. + The action used to configure the options. + The current . + + + + Register a validation action for an options type using a default failure message. + + The validation function. + The current . + + + + Register a validation action for an options type. + + The validation function. + The failure message to use when validation fails. + The current . + + + + Register a validation action for an options type using a default failure message. + + The dependency used by the validation function. + The validation function. + The current . + + + + Register a validation action for an options type. + + The dependency used by the validation function. + The validation function. + The failure message to use when validation fails. + The current . + + + + Register a validation action for an options type using a default failure message. + + The first dependency used by the validation function. + The second dependency used by the validation function. + The validation function. + The current . + + + + Register a validation action for an options type. + + The first dependency used by the validation function. + The second dependency used by the validation function. + The validation function. + The failure message to use when validation fails. + The current . + + + + Register a validation action for an options type using a default failure message. + + The first dependency used by the validation function. + The second dependency used by the validation function. + The third dependency used by the validation function. + The validation function. + The current . + + + + Register a validation action for an options type. + + The first dependency used by the validation function. + The second dependency used by the validation function. + The third dependency used by the validation function. + The validation function. + The failure message to use when validation fails. + The current . + + + + Register a validation action for an options type using a default failure message. + + The first dependency used by the validation function. + The second dependency used by the validation function. + The third dependency used by the validation function. + The fourth dependency used by the validation function. + The validation function. + The current . + + + + Register a validation action for an options type. + + The first dependency used by the validation function. + The second dependency used by the validation function. + The third dependency used by the validation function. + The fourth dependency used by the validation function. + The validation function. + The failure message to use when validation fails. + The current . + + + + Register a validation action for an options type using a default failure message. + + The first dependency used by the validation function. + The second dependency used by the validation function. + The third dependency used by the validation function. + The fourth dependency used by the validation function. + The fifth dependency used by the validation function. + The validation function. + The current . + + + + Register a validation action for an options type. + + The first dependency used by the validation function. + The second dependency used by the validation function. + The third dependency used by the validation function. + The fourth dependency used by the validation function. + The fifth dependency used by the validation function. + The validation function. + The failure message to use when validation fails. + The current . + + + + Used to cache instances. + + The type of options being requested. + + + + Clears all options instances from the cache. + + + + + Gets a named options instance, or adds a new instance created with . + + The name of the options instance. + The func used to create the new instance. + The options instance. + + + + Gets a named options instance, if available. + + The name of the options instance. + The options instance. + true if the options were retrieved; otherwise, false. + + + + Tries to adds a new option to the cache, will return false if the name already exists. + + The name of the options instance. + The options instance. + Whether anything was added. + + + + Try to remove an options instance. + + The name of the options instance. + Whether anything was removed. + + + + Implementation of . + + The type of options being requested. + + + + Initializes a new instance with the specified options configurations. + + The configuration actions to run. + The initialization actions to run. + + + + Initializes a new instance with the specified options configurations. + + The configuration actions to run. + The initialization actions to run. + The validations to run. + + + + Returns a configured instance with the given . + + The name of the instance to create. + The created instance with the given . + One or more return failed when validating the instance been created. + The does not have a public parameterless constructor or is . + + + + Creates a new instance of options type. + + The name of the instance to create. + The created instance. + The does not have a public parameterless constructor or is . + + + + Implementation of and . + + Options type. + + + + Initializes a new instance with the specified options configurations. + + The factory to use to create options. + + + + The default configured instance, equivalent to Get(Options.DefaultName). + + + + + Returns a configured instance with the given . + + The name of the instance, if is used. + The instance that matches the given . + One or more return failed when validating the instance been created. + The does not have a public parameterless constructor or is . + + + + Implementation of . + + Options type. + + + + Constructor. + + The factory to use to create options. + The sources used to listen for changes to the options instance. + The cache used to store options. + + + + The present value of the options, equivalent to Get(Options.DefaultName). + + One or more return failed when validating the instance been created. + The does not have a public parameterless constructor or is . + + + + Returns a configured instance with the given . + + The name of the instance, if is used. + The instance that matches the given . + One or more return failed when validating the instance been created. + The does not have a public parameterless constructor or is . + + + + Registers a listener to be called whenever changes. + + The action to be invoked when has changed. + An which should be disposed to stop listening for changes. + + + + Removes all change registration subscriptions. + + + + + Extension methods for . + + + + + Registers a listener to be called whenever changes. + + The type of options instance being monitored. + The IOptionsMonitor. + The action to be invoked when has changed. + An which should be disposed to stop listening for changes. + + + + Thrown when options validation fails. + + + + + Constructor. + + The name of the options instance that failed. + The options type that failed. + The validation failure messages. + + + + The name of the options instance that failed. + + + + + The type of the options that failed. + + + + + The validation failures. + + + + + The message is a semicolon separated list of the . + + + + + Triggers the automatic generation of the implementation of at compile time. + + + + + wrapper that returns the options instance. + + Options type. + + + + Initializes the wrapper with the options instance to return. + + The options instance to return. + + + + The options instance. + + + + + Implementation of . + + Options type being configured. + + + + Creates a new instance of . + + The name of the options. + The action to register. + + + + The options name. + + + + + The initialization action. + + + + + Invokes the registered initialization if the matches. + + The name of the action to invoke. + The options to use in initialization. + + + + Implementation of . + + Options type being configured. + Dependency type. + + + + Constructor. + + The name of the options. + A dependency. + The action to register. + + + + The options name. + + + + + The configuration action. + + + + + The dependency. + + + + + Invokes the registered initialization if the matches. + + The name of the options instance being configured. + The options instance to configured. + + + + Invoked to configure a instance using the . + + The options instance to configured. + + + + Implementation of . + + Options type being configured. + First dependency type. + Second dependency type. + + + + Constructor. + + The name of the options. + A dependency. + A second dependency. + The action to register. + + + + The options name. + + + + + The configuration action. + + + + + The first dependency. + + + + + The second dependency. + + + + + Invokes the registered initialization if the matches. + + The name of the options instance being configured. + The options instance to configured. + + + + Invoked to configure a instance using the . + + The options instance to configured. + + + + Implementation of . + + Options type being configured. + First dependency type. + Second dependency type. + Third dependency type. + + + + Constructor. + + The name of the options. + A dependency. + A second dependency. + A third dependency. + The action to register. + + + + The options name. + + + + + The configuration action. + + + + + The first dependency. + + + + + The second dependency. + + + + + The third dependency. + + + + + Invokes the registered initialization if the matches. + + The name of the options instance being configured. + The options instance to configured. + + + + Invoked to configure a instance using the . + + The options instance to configured. + + + + Implementation of . + + Options type being configured. + First dependency type. + Second dependency type. + Third dependency type. + Fourth dependency type. + + + + Constructor. + + The name of the options. + A dependency. + A second dependency. + A third dependency. + A fourth dependency. + The action to register. + + + + The options name. + + + + + The configuration action. + + + + + The first dependency. + + + + + The second dependency. + + + + + The third dependency. + + + + + The fourth dependency. + + + + + Invokes the registered initialization if the matches. + + The name of the options instance being configured. + The options instance to configured. + + + + Invoked to configure a instance using the . + + The options instance to configured. + + + + Implementation of . + + Options type being configured. + First dependency type. + Second dependency type. + Third dependency type. + Fourth dependency type. + Fifth dependency type. + + + + Constructor. + + The name of the options. + A dependency. + A second dependency. + A third dependency. + A fourth dependency. + A fifth dependency. + The action to register. + + + + The options name. + + + + + The configuration action. + + + + + The first dependency. + + + + + The second dependency. + + + + + The third dependency. + + + + + The fourth dependency. + + + + + The fifth dependency. + + + + + Invokes the registered initialization if the matches. + + The name of the options instance being configured. + The options instance to configured. + + + + Invoked to configure a instance using the . + + The options instance to configured. + + + + Marks a field or property to be enumerated, and each enumerated object to be validated. + + + + + Initializes a new instance of the class. + + + Using this constructor for a field/property tells the code generator to + generate validation for the individual members of the enumerable's type. + + + + + Initializes a new instance of the class. + + A type that implements for the enumerable's type. + + Using this constructor for a field/property tells the code generator to use the given type to validate + the object held by the enumerable. + + + + + Gets the type to use to validate the enumerable's objects. + + + + + Marks a field or property to be validated transitively. + + + + + Initializes a new instance of the class. + + + Using this constructor for a field/property tells the code generator to + generate validation for the individual members of the field/property's type. + + + + + Initializes a new instance of the class. + + A type that implements for the field/property's type. + + Using this constructor for a field/property tells the code generator to use the given type to validate + the object held by the field/property. + + + + + Gets the type to use to validate a field or property. + + + + + Implementation of + + The options type to validate. + + + + Constructor. + + Options name. + Validation function. + Validation failure message. + + + + The options name. + + + + + The validation function. + + + + + The error to return when validation fails. + + + + + Validates a specific named options instance (or all when is null). + + The name of the options instance being validated. + The options instance. + The result. + + + + Implementation of + + The options type to validate. + Dependency type. + + + + Constructor. + + Options name. + The dependency. + Validation function. + Validation failure message. + + + + The options name. + + + + + The validation function. + + + + + The error to return when validation fails. + + + + + The dependency. + + + + + Validates a specific named options instance (or all when is null). + + The name of the options instance being validated. + The options instance. + The result. + + + + Implementation of + + The options type to validate. + First dependency type. + Second dependency type. + + + + Constructor. + + Options name. + The first dependency. + The second dependency. + Validation function. + Validation failure message. + + + + The options name. + + + + + The validation function. + + + + + The error to return when validation fails. + + + + + The first dependency. + + + + + The second dependency. + + + + + Validates a specific named options instance (or all when is null). + + The name of the options instance being validated. + The options instance. + The result. + + + + Implementation of + + The options type to validate. + First dependency type. + Second dependency type. + Third dependency type. + + + + Constructor. + + Options name. + The first dependency. + The second dependency. + The third dependency. + Validation function. + Validation failure message. + + + + The options name. + + + + + The validation function. + + + + + The error to return when validation fails. + + + + + The first dependency. + + + + + The second dependency. + + + + + The third dependency. + + + + + Validates a specific named options instance (or all when is null). + + The name of the options instance being validated. + The options instance. + The result. + + + + Implementation of + + The options type to validate. + First dependency type. + Second dependency type. + Third dependency type. + Fourth dependency type. + + + + Constructor. + + Options name. + The first dependency. + The second dependency. + The third dependency. + The fourth dependency. + Validation function. + Validation failure message. + + + + The options name. + + + + + The validation function. + + + + + The error to return when validation fails. + + + + + The first dependency. + + + + + The second dependency. + + + + + The third dependency. + + + + + The fourth dependency. + + + + + Validates a specific named options instance (or all when is null). + + The name of the options instance being validated. + The options instance. + The result. + + + + Implementation of + + The options type to validate. + First dependency type. + Second dependency type. + Third dependency type. + Fourth dependency type. + Fifth dependency type. + + + + Constructor. + + Options name. + The first dependency. + The second dependency. + The third dependency. + The fourth dependency. + The fifth dependency. + Validation function. + Validation failure message. + + + + The options name. + + + + + The validation function. + + + + + The error to return when validation fails. + + + + + The first dependency. + + + + + The second dependency. + + + + + The third dependency. + + + + + The fourth dependency. + + + + + The fifth dependency. + + + + + Validates a specific named options instance (or all when is null). + + The name of the options instance being validated. + The options instance. + The result. + + + + Represents the result of an options validation. + + + + + Result when validation was skipped due to name not matching. + + + + + Validation was successful. + + + + + True if validation was successful. + + + + + True if validation was not run. + + + + + True if validation failed. + + + + + Used to describe why validation failed. + + + + + Full list of failures (can be multiple). + + + + + Returns a failure result. + + The reason for the failure. + The failure result. + + + + Returns a failure result. + + The reasons for the failure. + The failure result. + + + + Builds with support for multiple error messages. + + + + + Creates new instance of the class. + + + + + Adds a new validation error to the builder. + + Content of error message. + The property in the option object which contains an error. + + + + Adds any validation error carried by the instance to this instance. + + The instance to append the error from. + + + + Adds any validation error carried by the enumeration of instances to this instance. + + The enumeration to consume the errors from. + + + + Adds any validation errors carried by the instance to this instance. + + The instance to consume the errors from. + + + + Builds based on provided data. + + New instance of . + + + + Reset the builder to the empty state + + + + + Extension methods for adding configuration related options services to the DI container via . + + + + + Enforces options validation check on start rather than in runtime. + + The type of options. + The to configure options instance. + The so that additional calls can be chained. + + + + Extension methods for adding options services to the DI container. + + + + + Adds services required for using options. + + The to add the services to. + The so that additional calls can be chained. + + + + Adds services required for using options and enforces options validation check on start rather than in runtime. + + + The extension is called by this method. + + The options type to be configured. + The to add the services to. + The name of the options instance. + The so that additional calls can be chained. + + + + Adds services required for using options and enforces options validation check on start rather than in runtime. + + + The extension is called by this method. + + The options type to be configured. + The validator type. + The to add the services to. + The name of the options instance. + The so that additional calls can be chained. + + + + Registers an action used to configure a particular type of options. + Note: These are run before all . + + The options type to be configured. + The to add the services to. + The action used to configure the options. + The so that additional calls can be chained. + + + + Registers an action used to configure a particular type of options. + Note: These are run before all . + + The options type to be configured. + The to add the services to. + The name of the options instance. + The action used to configure the options. + The so that additional calls can be chained. + + + + Registers an action used to configure all instances of a particular type of options. + + The options type to be configured. + The to add the services to. + The action used to configure the options. + The so that additional calls can be chained. + + + + Registers an action used to initialize a particular type of options. + Note: These are run after all . + + The options type to be configured. + The to add the services to. + The action used to configure the options. + The so that additional calls can be chained. + + + + Registers an action used to configure a particular type of options. + Note: These are run after all . + + The options type to be configure. + The to add the services to. + The name of the options instance. + The action used to configure the options. + The so that additional calls can be chained. + + + + Registers an action used to post configure all instances of a particular type of options. + Note: These are run after all . + + The options type to be configured. + The to add the services to. + The action used to configure the options. + The so that additional calls can be chained. + + + + Registers a type that will have all of its , + , and + registered. + + The type that will configure options. + The to add the services to. + The so that additional calls can be chained. + + + + Registers a type that will have all of its , + , and + registered. + + The to add the services to. + The type that will configure options. + The so that additional calls can be chained. + + + + Registers an object that will have all of its , + , and + registered. + + The to add the services to. + The instance that will configure options. + The so that additional calls can be chained. + + + + Gets an options builder that forwards Configure calls for the same to the underlying service collection. + + The options type to be configured. + The to add the services to. + The so that configure calls can be chained in it. + + + + Gets an options builder that forwards Configure calls for the same named to the underlying service collection. + + The options type to be configured. + The to add the services to. + The name of the options instance. + The so that configure calls can be chained in it. + + + Throws an if is null. + The reference type argument to validate as non-null. + The name of the parameter with which corresponds. + + + + Throws either an or an + if the specified string is or whitespace respectively. + + String to be checked for or whitespace. + The name of the parameter being checked. + The original value of . + + + + Attribute used to indicate a source generator should create a function for marshalling + arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time. + + + This attribute is meaningless if the source generator associated with it is not enabled. + The current built-in source generator only supports C# and only supplies an implementation when + applied to static, partial, non-generic methods. + + + + + Initializes a new instance of the . + + Name of the library containing the import. + + + + Gets the name of the library containing the import. + + + + + Gets or sets the name of the entry point to be called. + + + + + Gets or sets how to marshal string arguments to the method. + + + If this field is set to a value other than , + must not be specified. + + + + + Gets or sets the used to control how string arguments to the method are marshalled. + + + If this field is specified, must not be specified + or must be set to . + + + + + Gets or sets whether the callee sets an error (SetLastError on Windows or errno + on other platforms) before returning from the attributed method. + + + + + Specifies how strings should be marshalled for generated p/invokes + + + + + Indicates the user is suppling a specific marshaller in . + + + + + Use the platform-provided UTF-8 marshaller. + + + + + Use the platform-provided UTF-16 marshaller. + + + + + Indicates that certain members on a specified are accessed dynamically, + for example through . + + + This allows tools to understand which members are being accessed during the execution + of a program. + + This attribute is valid on members whose type is or . + + When this attribute is applied to a location of type , the assumption is + that the string represents a fully qualified type name. + + When this attribute is applied to a class, interface, or struct, the members specified + can be accessed dynamically on instances returned from calling + on instances of that class, interface, or struct. + + If the attribute is applied to a method it's treated as a special case and it implies + the attribute should be applied to the "this" parameter of the method. As such the attribute + should only be used on instance methods of types assignable to System.Type (or string, but no methods + will use it there). + + + + + Initializes a new instance of the class + with the specified member types. + + The types of members dynamically accessed. + + + + Gets the which specifies the type + of members dynamically accessed. + + + + + Specifies the types of members that are dynamically accessed. + + This enumeration has a attribute that allows a + bitwise combination of its member values. + + + + + Specifies no members. + + + + + Specifies the default, parameterless public constructor. + + + + + Specifies all public constructors. + + + + + Specifies all non-public constructors. + + + + + Specifies all public methods. + + + + + Specifies all non-public methods. + + + + + Specifies all public fields. + + + + + Specifies all non-public fields. + + + + + Specifies all public nested types. + + + + + Specifies all non-public nested types. + + + + + Specifies all public properties. + + + + + Specifies all non-public properties. + + + + + Specifies all public events. + + + + + Specifies all non-public events. + + + + + Specifies all interfaces implemented by the type. + + + + + Specifies all members. + + + + + Suppresses reporting of a specific rule violation, allowing multiple suppressions on a + single code artifact. + + + is different than + in that it doesn't have a + . So it is always preserved in the compiled assembly. + + + + + Initializes a new instance of the + class, specifying the category of the tool and the identifier for an analysis rule. + + The category for the attribute. + The identifier of the analysis rule the attribute applies to. + + + + Gets the category identifying the classification of the attribute. + + + The property describes the tool or tool analysis category + for which a message suppression attribute applies. + + + + + Gets the identifier of the analysis tool rule to be suppressed. + + + Concatenated together, the and + properties form a unique check identifier. + + + + + Gets or sets the scope of the code that is relevant for the attribute. + + + The Scope property is an optional argument that specifies the metadata scope for which + the attribute is relevant. + + + + + Gets or sets a fully qualified path that represents the target of the attribute. + + + The property is an optional argument identifying the analysis target + of the attribute. An example value is "System.IO.Stream.ctor():System.Void". + Because it is fully qualified, it can be long, particularly for targets such as parameters. + The analysis tool user interface should be capable of automatically formatting the parameter. + + + + + Gets or sets an optional argument expanding on exclusion criteria. + + + The property is an optional argument that specifies additional + exclusion where the literal metadata target is not sufficiently precise. For example, + the cannot be applied within a method, + and it may be desirable to suppress a violation against a statement in the method that will + give a rule violation, but not against all statements in the method. + + + + + Gets or sets the justification for suppressing the code analysis message. + + + + Specifies that null is allowed as an input even if the corresponding type disallows it. + + + Specifies that null is disallowed as an input even if the corresponding type allows it. + + + Specifies that an output may be null even if the corresponding type disallows it. + + + Specifies that an output will not be null even if the corresponding type allows it. Specifies that an input argument was not null when the call returns. + + + Specifies that when a method returns , the parameter may be null even if the corresponding type disallows it. + + + Initializes the attribute with the specified return value condition. + + The return value condition. If the method returns this value, the associated parameter may be null. + + + + Gets the return value condition. + + + 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 the output will be non-null if the named parameter is non-null. + + + Initializes the attribute with the associated parameter name. + + The associated parameter name. The output will be non-null if the argument to the parameter specified is non-null. + + + + Gets the associated parameter name. + + + Applied to a method that will never return under any circumstance. + + + Specifies that the method will not return if the associated Boolean parameter is passed the specified value. + + + Initializes the attribute with the specified parameter value. + + 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. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values. + + + Initializes the attribute with a field or property member. + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the list of field and property members. + + The list of field and property members that are promised to be not-null. + + + + Gets field or property member names. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values when returning with the specified return value condition. + + + Initializes the attribute with the specified return value condition and a field or property member. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the specified return value condition and list of field and property members. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The list of field and property members that are promised to be not-null. + + + + Gets the return value condition. + + + Gets field or property member names. + + + Cannot create instance of type '{0}' because it is either abstract or an interface. + + + Failed to convert '{0}' to type '{1}'. + + + Failed to create instance of type '{0}'. + + + Cannot create instance of type '{0}' because it is missing a public parameterless constructor. + + + No IConfigureOptions<>, IPostConfigureOptions<>, or IValidateOptions<> implementations were found. + + + No IConfigureOptions<>, IPostConfigureOptions<>, or IValidateOptions<> implementations were found, did you mean to call Configure<> or PostConfigure<>? + + + diff --git a/Bin/Microsoft.Extensions.Primitives.dll b/Bin/Microsoft.Extensions.Primitives.dll index 604a57fab..24f500cfe 100644 Binary files a/Bin/Microsoft.Extensions.Primitives.dll and b/Bin/Microsoft.Extensions.Primitives.dll differ diff --git a/Bin/Microsoft.Extensions.Primitives.dll.refresh b/Bin/Microsoft.Extensions.Primitives.dll.refresh new file mode 100644 index 000000000..a0d061368 Binary files /dev/null and b/Bin/Microsoft.Extensions.Primitives.dll.refresh differ diff --git a/Bin/Microsoft.Extensions.Primitives.xml b/Bin/Microsoft.Extensions.Primitives.xml index f29304810..3cd58c319 100644 --- a/Bin/Microsoft.Extensions.Primitives.xml +++ b/Bin/Microsoft.Extensions.Primitives.xml @@ -1,756 +1,1248 @@ - + - - Microsoft.Extensions.Primitives - - - - A implementation using . - - - Initializes a new instance of . - The . - - - Registers for a callback that will be invoked when the entry has changed. must be set before the callback is invoked. - The to invoke. - State to be passed into the callback. - An that is used to unregister the callback. - - - Indicates if this token will pro-actively raise callbacks. If , the token consumer must poll to detect changes. - - if the token will proactively raise callbacks; otherwise. - - - Gets a value that indicates if a change has occurred. - - if a change has occured; otherwise. - - - Propagates notifications that a change has occurred. - - - Registers the action to be called whenever the token produced changes. - Produces the change token. - Action called when the token changes. - - - - Registers the action to be called whenever the token produced changes. - Produces the change token. - Action called when the token changes. - state for the consumer. - The type of the state for the action. - - - - An which represents one or more instances. - - - Creates a new instance of . - The list of to compose. - - - Registers for a callback that will be invoked when the entry has changed. must be set before the callback is invoked. - The to invoke. - State to be passed into the callback. - An that is used to unregister the callback. - - - Indicates if this token will pro-actively raise callbacks. If , the token consumer must poll to detect changes. - - if the token will proactively raise callbacks; otherwise. - - - Returns the list of which compose the current . - The list of instances which compose the current . - - - Gets a value that indicates if a change has occurred. - - if a change has occured; otherwise. - - - - Add the given to the . - The to add to. - The to add. - The original . - - - Propagates notifications that a change has occurred. - - - Registers for a callback that will be invoked when the entry has changed. - MUST be set before the callback is invoked. - The to invoke. - State to be passed into the callback. - An that is used to unregister the callback. - - - Indicates if this token will pro-actively raise callbacks. If , the token consumer must - poll to detect changes. - - if the token will proactively raise callbacks; otherwise. - - - Gets a value that indicates if a change has occurred. - - if a change has occurred; otherwise. - - - An optimized representation of a substring. - - - A for . - - - Initializes an instance of the struct. - - The original . The includes the whole . - - - Initializes an instance of the struct. - The original used as buffer. - The offset of the segment within the . - The length of the segment. - - is . - - or is less than zero, or + - is greater than the number of characters in . - - - Gets a from the current . - The from this . - - - Gets a from the current . - The from this . - - - Compares substrings of two specified objects using the specified rules, - and returns an integer that indicates their relative position in the sort order. - The first to compare. - The second to compare. - One of the enumeration values that specifies the rules for the comparison. - + + Microsoft.Extensions.Primitives + + + + + A implementation using . + + + + + Initializes a new instance of . + + The . + + + + + + + + + + + + + Propagates notifications that a change has occurred. + + + + + Registers the action to be called whenever the token produced changes. + + Produces the change token. + Action called when the token changes. + + + + + Registers the action to be called whenever the token produced changes. + + Produces the change token. + Action called when the token changes. + state for the consumer. + + + + + An which represents one or more instances. + + + + + Creates a new instance of . + + The list of to compose. + + + + Returns the list of which compose the current . + + + + + + + + + + + + + + Provides extensions methods for the namespace. + + + + + Add the given to the . + + The to add to. + The to add. + The original . + + + + Propagates notifications that a change has occurred. + + + + + Gets a value that indicates if a change has occurred. + + + + + Indicates if this token will pro-actively raise callbacks. If false, the token consumer must + poll to detect changes. + + + + + Registers for a callback that will be invoked when the entry has changed. + MUST be set before the callback is invoked. + + The to invoke. + State to be passed into the callback. + An that is used to unregister the callback. + + + + Provides a mechanism for fast, non-allocating string concatenation. + + + + + Initializes a new instance of the class. + + The suggested starting size of the instance. + + + + Gets the number of characters that the current object can contain. + + + + + Appends a string to the end of the current instance. + + The string to append. + + + + Appends a string segment to the end of the current instance. + + The string segment to append. + + + + Appends a substring to the end of the current instance. + + The string that contains the substring to append. + The starting position of the substring within value. + The number of characters in value to append. + + + + Appends a character to the end of the current instance. + + The character to append. + + + + Converts the value of this instance to a String. + + A string whose value is the same as this instance. + + + + An optimized representation of a substring. + + + + + A for . + + + + + Initializes an instance of the struct. + + + The original . The includes the whole . + + + + + Initializes an instance of the struct. + + The original used as buffer. + The offset of the segment within the . + The length of the segment. + + is . + + + or is less than zero, or + + is greater than the number of characters in . + + + + + Gets the buffer for this . + + + + + Gets the offset within the buffer for this . + + + + + Gets the length of this . + + + + + Gets the value of this segment as a . + + + + + Gets whether this contains a valid value. + + + + + Gets the at a specified position in the current . + + The offset into the + The at a specified position. + + is greater than or equal to or less than zero. + + + + + Gets a from the current . + + The from this . + + + + Gets a from the current that starts + at the position specified by , and has the remaining length. + + The zero-based starting character position in this . + A with the remaining chars that begins at in + this . + + is greater than or equal to or less than zero. + + + + + Gets a from the current that starts + at the position specified by , and has the specified . + + The zero-based starting character position in this . + The number of characters in the span. + A with that begins at + in this . + + or is less than zero, or + is + greater than . + + + + + Gets a from the current . + + The from this . + + + + Compares substrings of two specified objects using the specified rules, + and returns an integer that indicates their relative position in the sort order. + + The first to compare. + The second to compare. + One of the enumeration values that specifies the rules for the comparison. + A 32-bit signed integer indicating the lexical relationship between the two comparands. - The value is negative if is less than , 0 if the two comparands are equal, - and positive if is greater than . - . - - - Checks if the end of this matches the specified when compared using the specified . - The to compare. - One of the enumeration values that specifies the rules to use in the comparison. - - is . - - if matches the end of this ; otherwise, . - - - Indicates whether the current object is equal to another object of the same type. - An object to compare with this object. - - if the current object is equal to the other parameter; otherwise, . - - - Determines whether two specified objects have the same value. A parameter specifies the culture, case, and - sort rules used in the comparison. - The first to compare. - The second to compare. - One of the enumeration values that specifies the rules for the comparison. - - if the objects are equal; otherwise, . - - - Indicates whether the current object is equal to another object of the same type. - An object to compare with this object. - One of the enumeration values that specifies the rules to use in the comparison. - - if the current object is equal to the other parameter; otherwise, . - - - - - - Checks if the specified is equal to the current . - The to compare with the current . - - if the specified is equal to the current ; otherwise, . - - - Checks if the specified is equal to the current . - The to compare with the current . - One of the enumeration values that specifies the rules to use in the comparison. - - is . - - if the specified is equal to the current ; otherwise, . - - - - Gets the zero-based index of the first occurrence of the character in this . - The Unicode character to seek. - The zero-based index position of from the beginning of the if that character is found, or -1 if it is not. - - - Gets the zero-based index of the first occurrence of the character in this . - The search starts at . - The Unicode character to seek. - The zero-based index position at which the search starts. - - is greater than or equal to or less than zero. - The zero-based index position of from the beginning of the if that character is found, or -1 if it is not. - - - Gets the zero-based index of the first occurrence of the character in this . - The search starts at and examines a specified number of character positions. - The Unicode character to seek. - The zero-based index position at which the search starts. - The number of characters to examine. - - or is less than zero, or + is - greater than . - The zero-based index position of from the beginning of the if that character is found, or -1 if it is not. - - - Reports the zero-based index of the first occurrence in this instance of any character in a specified array - of Unicode characters. - A Unicode character array containing one or more characters to seek. - The zero-based index position of the first occurrence in this instance where any character in - was found; -1 if no character in was found. - - - Reports the zero-based index of the first occurrence in this instance of any character in a specified array - of Unicode characters. The search starts at a specified character position. - A Unicode character array containing one or more characters to seek. - The search starting position. - - is greater than or equal to or less than zero. - The zero-based index position of the first occurrence in this instance where any character in - was found; -1 if no character in was found. - - - Reports the zero-based index of the first occurrence in this instance of any character in a specified array - of Unicode characters. The search starts at a specified character position and examines a specified number - of character positions. - A Unicode character array containing one or more characters to seek. - The search starting position. - The number of character positions to examine. - - is . - - or is less than zero, or + is - greater than . - The zero-based index position of the first occurrence in this instance where any character in - was found; -1 if no character in was found. - - - Indicates whether the specified is null or an Empty string. - The to test. - - - - Reports the zero-based index position of the last occurrence of a specified Unicode character within this instance. - The Unicode character to seek. - The zero-based index position of value if that character is found, or -1 if it is not. - - - Checks if two specified have the same value. - The first to compare, or . - The second to compare, or . - - if the value of is the same as the value of ; otherwise, . - - - Creates a see from the given . - The to convert to a . - - - Creates a see from the given . - The to convert to a . - - - Creates a new from the given . - The to convert to a - - - Checks if two specified have different values. - The first to compare, or . - The second to compare, or . - - if the value of is different from the value of ; otherwise, . - - - Splits a string into s that are based on the characters in an array. - A character array that delimits the substrings in this string, an empty array that - contains no delimiters, or null. - An whose elements contain the s from this instance - that are delimited by one or more characters in . - - - Checks if the beginning of this matches the specified when compared using the specified . - The to compare. - One of the enumeration values that specifies the rules to use in the comparison. - - is . - - if matches the beginning of this ; otherwise, . - - - Retrieves a that represents a substring from this . - The starts at the position specified by . - The zero-based starting character position of a substring in this . - - is greater than or equal to or less than zero. - A that begins at in this + The value is negative if is less than , 0 if the two comparands are equal, + and positive if is greater than . + + + + + Indicates whether the current object is equal to another object of the same type. + + An object to compare with this object. + if the current object is equal to the other parameter; otherwise, . + + + + Indicates whether the current object is equal to another object of the same type. + + An object to compare with this object. + if the current object is equal to the other parameter; otherwise, . + + + + Indicates whether the current object is equal to another object of the same type. + + An object to compare with this object. + One of the enumeration values that specifies the rules to use in the comparison. + if the current object is equal to the other parameter; otherwise, . + + + + Determines whether two specified objects have the same value. A parameter specifies the culture, case, and + sort rules used in the comparison. + + The first to compare. + The second to compare. + One of the enumeration values that specifies the rules for the comparison. + if the objects are equal; otherwise, . + + + + Checks if the specified is equal to the current . + + The to compare with the current . + if the specified is equal to the current ; otherwise, . + + + + Checks if the specified is equal to the current . + + The to compare with the current . + One of the enumeration values that specifies the rules to use in the comparison. + if the specified is equal to the current ; otherwise, . + + + + 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. + + + + + Checks if two specified have the same value. + + The first to compare, or . + The second to compare, or . + if the value of is the same as the value of ; otherwise, . + + + + Checks if two specified have different values. + + The first to compare, or . + The second to compare, or . + if the value of is different from the value of ; otherwise, . + + + + Creates a new from the given . + + The to convert to a + + + + Creates a see from the given . + + The to convert to a . + + + + Creates a see from the given . + + The to convert to a . + + + + Checks if the beginning of this matches the specified when compared using the specified . + + The to compare. + One of the enumeration values that specifies the rules to use in the comparison. + if matches the beginning of this ; otherwise, . + + is . + + + + + Checks if the end of this matches the specified when compared using the specified . + + The to compare. + One of the enumeration values that specifies the rules to use in the comparison. + if matches the end of this ; otherwise, . + + is . + + + + + Retrieves a substring from this . + The substring starts at the position specified by and has the remaining length. + + The zero-based starting character position of a substring in this . + A that is equivalent to the substring of remaining length that begins at + in this + + is greater than or equal to or less than zero. + + + + + Retrieves a substring from this . + The substring starts at the position specified by and has the specified . + + The zero-based starting character position of a substring in this . + The number of characters in the substring. + A that is equivalent to the substring of that begins at + in this + + or is less than zero, or + is + greater than . + + + + + Retrieves a that represents a substring from this . + The starts at the position specified by . + + The zero-based starting character position of a substring in this . + A that begins at in this whose length is the remainder. - - - Retrieves a that represents a substring from this . - The starts at the position specified by and has the specified . - The zero-based starting character position of a substring in this . - The number of characters in the substring. - - or is less than zero, or + is - greater than . - A that is equivalent to the substring of length that begins at in this - - - Retrieves a substring from this . - The substring starts at the position specified by and has the remaining length. - The zero-based starting character position of a substring in this . - - is greater than or equal to or less than zero. - A that is equivalent to the substring of remaining length that begins at - in this - - - Retrieves a substring from this . - The substring starts at the position specified by and has the specified . - The zero-based starting character position of a substring in this . - The number of characters in the substring. - - or is less than zero, or + is - greater than . - A that is equivalent to the substring of length that begins at - in this - - - Returns the represented by this or if the does not contain a value. - The represented by this or if the does not contain a value. - - - Removes all leading and trailing whitespaces. - The trimmed . - - - Removes all trailing whitespaces. - The trimmed . - - - Removes all leading whitespaces. - The trimmed . - - - Gets the buffer for this . - The buffer for this . - - - Gets whether this contains a valid value. - - if the contains a valid value; otherwise. - - - Gets the at a specified position in the current . - The offset into the - - is greater than or equal to or less than zero. - The at a specified position. - - - Gets the length of this . - The length of this . - - - Gets the offset within the buffer for this . - The offset within the buffer for this . - - - Gets the value of this segment as a . - The value of this segment as a . - - - - Compares two objects and returns a value indicating whether one is less than, equal to, or greater than the other. - The first object to compare. - The second object to compare. - A signed integer that indicates the relative values of and . - - - Determines whether the specified objects are equal. - The first object of type to compare. - The second object of type to compare. - - if the specified objects are equal; otherwise, . - - - 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. - - - - - Tokenizes a into s. - - - Initializes a new instance of . - The to tokenize. - The characters to tokenize by. - - - Initializes a new instance of . - The to tokenize. - The characters to tokenize by. - - - - Returns an enumerator that iterates through the collection. - An enumerator that can be used to iterate through the collection. - - - Returns an enumerator that iterates through a collection. - An object that can be used to iterate through the collection. - - - - - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Advances the enumerator to the next element of the collection. - - if the enumerator was successfully advanced to the next element; 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. - - - Gets the element in the collection at the current position of the enumerator. - The element in the collection at the current position of the enumerator. - - - Gets the element in the collection at the current position of the enumerator. - The element in the collection at the current position of the enumerator. - - - Represents zero/null, one, or many strings in an efficient way. - - - A readonly instance of the struct whose value is an empty string array. - - - Initializes a new instance of the structure using the specified string. - A string value or . - - - Initializes a new instance of the structure using the specified array of strings. - A string array. - - - Concatenates two specified instances of . - The first to concatenate. - The second to concatenate. - The concatenation of and . - - - Concatenates specified instance of with specified . - The to concatenate. - The string to concatenate. - The concatenation of and . - - - Concatenates specified instance of with specified . - The string to concatenate. - The to concatenate. - The concatenation of and . - - - Determines whether this instance and another specified object have the same values. - The string to compare to this instance. - - if the value of is the same as the value of this instance; otherwise, . - - - Determines whether two specified objects have the same values in the same order. - The first to compare. - The second to compare. - - if the value of is the same as the value of ; otherwise, . - - - Determines whether the specified and objects have the same values. - The to compare. - The to compare. - - if the value of is the same as the value of ; otherwise, . If is , the method returns . - - - Determines whether the specified and string array objects have the same values. - The to compare. - The string array to compare. - - if the value of is the same as the value of ; otherwise, . - - - Determines whether this instance and a specified object have the same value. - An object to compare with this object. - - if the current object is equal to ; otherwise, . - - - Determines whether this instance and a specified string have the same value. - The string to compare to this instance. - - if the value of is the same as this instance; otherwise, . If is , returns . - - - Determines whether the specified and objects have the same values. - The string to compare. - The to compare. - - if the value of is the same as the value of ; otherwise, . If is , the method returns . - - - Determines whether this instance and a specified string array have the same values. - The string array to compare to this instance. - - if the value of is the same as this instance; otherwise, . - - - Determines whether the specified string array and objects have the same values. - The string array to compare. - The to compare. - - if the value of is the same as the value of ; otherwise, . - - - Retrieves an object that can iterate through the individual strings in this . - An enumerator that can be used to iterate through the . - - - - Indicates whether the specified contains no string values. - The to test. - - if value contains a single string or empty array; otherwise, . - - - Determines whether two specified have the same values. - The first to compare. - The second to compare. - - if the value of is the same as the value of ; otherwise, . - - - Determines whether the specified and , which must be a , , or array of , have the same value. - The to compare. - The to compare. - - if the object is equal to the ; otherwise, . - - - - - - - - - - - Determines whether the specified , which must be a , , or array of , and specified , have the same value. - The to compare. - The to compare. - - if the object is equal to the ; otherwise, . - - - - - - - - - - - Defines an implicit conversion of a given to a string, with multiple values joined as a comma separated string. - A to implicitly convert. - Returns where has been initialized from an empty string array or is . Otherwise, it returns the implicit conversion of to a string. - - - Defines an implicit conversion of a given to a string array. - A to implicitly convert. - - - Defines an implicit conversion of a given string to a . - A string to implicitly convert. - - - Defines an implicit conversion of a given string array to a . - A string array to implicitly convert. - - - Determines whether two specified have different values. - The first to compare. - The second to compare. - - if the value of is different to the value of ; otherwise, . - - - Determines whether the specified and , which must be a , , or array of , have different values. - The to compare. - The to compare. - - if the object is equal to the ; otherwise, . - - - Determines whether the specified and objects have different values. - The to compare. - The to compare. - - if the value of is different to the value of ; otherwise, . - - - Determines whether the specified and string array have different values. - The to compare. - The string array to compare. - - if the value of is different to the value of ; otherwise, . - - - Determines whether the specified and object have the same values. - The to compare. - The to compare. - - if the object is equal to the ; otherwise, . - - - Determines whether the specified and objects have different values. - The string to compare. - The to compare. - - if the value of is different to the value of ; otherwise, . - - - Determines whether the specified string array and have different values. - The string array to compare. - The to compare. - - if the value of is different to the value of ; otherwise, . - - - Adds an item to the collection. - The object to add to the collection. - - - Removes all items from the collection. - - - Determines whether a string is in the . - The string to locate in the . - - if is found in the ; otherwise, . - - - Copies the entire to a string 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 the destination array at which copying begins. - - - Removes the first occurrence of a specific object from the collection. - The object to remove from the collection. - - if was successfully removed from the collection; otherwise, . This method also returns if is not found in the original collection. - - - Returns an enumerator that iterates through the collection. - An enumerator that can be used to iterate through the collection. - - - Returns the zero-based index of the first occurrence of an item in the . - The string to locate in the . - the zero-based index of the first occurrence of within the , if found; 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 . - - - Removes the item at the specified index. - The zero-based index of the item to remove. - - - Returns an enumerator that iterates through a collection. - An object that can be used to iterate through the collection. - - - Creates a string array from the current object. - A string array represented by this instance. - - - Converts the value of the current object to its equivalent string representation, with multiple values joined as a comma separated string. - A string representation of the value of the current object. - - - Gets the number of string elements contained in this . - The number of string elements contained in this . - - - Gets the string at index. - The zero-based index of the element to get. - The string at the specified index. - - - Gets a value indicating whether the collection is read-only. - - if the collection is read-only; otherwise, . - - - Gets the at index. - The zero-based index of the element to get. - The string at the specified index. - - - Enumerates the string values of a . - - - - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Advances the enumerator to the next element of the collection. - - if the enumerator was successfully advanced to the next element; 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. - - - Gets the element in the collection at the current position of the enumerator. - The element in the collection at the current position of the enumerator. - - - Gets the element in the collection at the current position of the enumerator. - The element in the collection at the current position of the enumerator. - - - \ No newline at end of file + + is greater than or equal to or less than zero. + + + + + Retrieves a that represents a substring from this . + The starts at the position specified by and has the specified . + + The zero-based starting character position of a substring in this . + The number of characters in the substring. + A that is equivalent to the substring of that begins at in this + + or is less than zero, or + is + greater than . + + + + + Gets the zero-based index of the first occurrence of the character in this . + The search starts at and examines a specified number of character positions. + + The Unicode character to seek. + The zero-based index position at which the search starts. + The number of characters to examine. + The zero-based index position of from the beginning of the if that character is found, or -1 if it is not. + + or is less than zero, or + is + greater than . + + + + + Gets the zero-based index of the first occurrence of the character in this . + The search starts at . + + The Unicode character to seek. + The zero-based index position at which the search starts. + The zero-based index position of from the beginning of the if that character is found, or -1 if it is not. + + is greater than or equal to or less than zero. + + + + + Gets the zero-based index of the first occurrence of the character in this . + + The Unicode character to seek. + The zero-based index position of from the beginning of the if that character is found, or -1 if it is not. + + + + Reports the zero-based index of the first occurrence in this instance of any character in a specified array + of Unicode characters. The search starts at a specified character position and examines a specified number + of character positions. + + A Unicode character array containing one or more characters to seek. + The search starting position. + The number of character positions to examine. + The zero-based index position of the first occurrence in this instance where any character in + was found; -1 if no character in was found. + + is . + + + or is less than zero, or + is + greater than . + + + + + Reports the zero-based index of the first occurrence in this instance of any character in a specified array + of Unicode characters. The search starts at a specified character position. + + A Unicode character array containing one or more characters to seek. + The search starting position. + The zero-based index position of the first occurrence in this instance where any character in + was found; -1 if no character in was found. + + is greater than or equal to or less than zero. + + + + + Reports the zero-based index of the first occurrence in this instance of any character in a specified array + of Unicode characters. + + A Unicode character array containing one or more characters to seek. + The zero-based index position of the first occurrence in this instance where any character in + was found; -1 if no character in was found. + + + + Reports the zero-based index position of the last occurrence of a specified Unicode character within this instance. + + The Unicode character to seek. + The zero-based index position of value if that character is found, or -1 if it is not. + + + + Removes all leading and trailing whitespaces. + + The trimmed . + + + + Removes all leading whitespaces. + + The trimmed . + + + + Removes all trailing whitespaces. + + The trimmed . + + + + Splits a string into s that are based on the characters in an array. + + A character array that delimits the substrings in this string, an empty array that + contains no delimiters, or null. + An whose elements contain the s from this instance + that are delimited by one or more characters in . + + + + Indicates whether the specified is null or an Empty string. + + The to test. + + + + + Returns the represented by this or if the does not contain a value. + + The represented by this or if the does not contain a value. + + + + Compares two objects. + + + + + Gets a object that performs a case-sensitive ordinal comparison. + + + + + Gets a object that performs a case-insensitive ordinal comparison. + + + + + Compares two objects and returns an indication of their relative sort order. + + The first to compare. + The second to compare. + A 32-bit signed integer that indicates the lexical relationship between the two comparands. + + + + Determines whether two objects are equal. + + The first to compare. + The second to compare. + if the two objects are equal; otherwise, . + + + + Returns a hash code for a object. + + The to get a hash code for. + A hash code for a , suitable for use in hashing algorithms and data structures like a hash table. + + + + Tokenizes a into s. + + + + + Initializes a new instance of . + + The to tokenize. + The characters to tokenize by. + + + + Initializes a new instance of . + + The to tokenize. + The characters to tokenize by. + + + + Initializes a new instance of . + + An based on the 's value and separators. + + + + Enumerates the tokens represented by . + + + + + Initializes an using a . + + containing value and separators for enumeration. + + + + Gets the current from the . + + + + + Releases all resources used by the . + + + + + Advances the enumerator to the next token in the . + + if the enumerator was successfully advanced to the next token; if the enumerator has passed the end of the . + + + + Resets the to its initial state. + + + + + Represents zero/null, one, or many strings in an efficient way. + + + + + A readonly instance of the struct whose value is an empty string array. + + + In application code, this field is most commonly used to safely represent a that has null string values. + + + + + Initializes a new instance of the structure using the specified string. + + A string value or null. + + + + Initializes a new instance of the structure using the specified array of strings. + + A string array. + + + + Defines an implicit conversion of a given string to a . + + A string to implicitly convert. + + + + Defines an implicit conversion of a given string array to a . + + A string array to implicitly convert. + + + + Defines an implicit conversion of a given to a string, with multiple values joined as a comma separated string. + + + Returns null where has been initialized from an empty string array or is . + + A to implicitly convert. + + + + Defines an implicit conversion of a given to a string array. + + A to implicitly convert. + + + + Gets the number of elements contained in this . + + + + + Gets the at index. + + The string at the specified index. + The zero-based index of the element to get. + Set operations are not supported on readonly . + + + + Gets the at index. + + The string at the specified index. + The zero-based index of the element to get. + + + + Converts the value of the current object to its equivalent string representation, with multiple values joined as a comma separated string. + + A string representation of the value of the current object. + + + + Creates a string array from the current object. + + A string array represented by this instance. + + If the contains a single string internally, it is copied to a new array. + If the contains an array internally it returns that array instance. + + + + + Returns the zero-based index of the first occurrence of an item in the . + + The string to locate in the . + the zero-based index of the first occurrence of within the , if found; otherwise, -1. + + + Determines whether a string is in the . + The to locate in the . + true if item is found in the ; otherwise, false. + + + + Copies the entire to a string 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 the destination array at which copying begins. + array is null. + arrayIndex is less than 0. + The number of elements in the source is greater than the available space from arrayIndex to the end of the destination array. + + + Retrieves an object that can iterate through the individual strings in this . + An enumerator that can be used to iterate through the . + + + + + + + + + + Indicates whether the specified contains no string values. + + The to test. + true if value contains a single null or empty string or an empty array; otherwise, false. + + + + Concatenates two specified instances of . + + The first to concatenate. + The second to concatenate. + The concatenation of and . + + + + Concatenates specified instance of with specified . + + The to concatenate. + The to concatenate. + The concatenation of and . + + + + Concatenates specified instance of with specified . + + The to concatenate. + The to concatenate. + The concatenation of and . + + + + Determines whether two specified objects have the same values in the same order. + + The first to compare. + The second to compare. + true if the value of is the same as the value of ; otherwise, false. + + + + Determines whether two specified have the same values. + + The first to compare. + The second to compare. + true if the value of is the same as the value of ; otherwise, false. + + + + Determines whether two specified have different values. + + The first to compare. + The second to compare. + true if the value of is different to the value of ; otherwise, false. + + + + Determines whether this instance and another specified object have the same values. + + The string to compare to this instance. + true if the value of is the same as the value of this instance; otherwise, false. + + + + Determines whether the specified and objects have the same values. + + The to compare. + The to compare. + true if the value of is the same as the value of ; otherwise, false. If is null, the method returns false. + + + + Determines whether the specified and objects have the same values. + + The to compare. + The to compare. + true if the value of is the same as the value of ; otherwise, false. If is null, the method returns false. + + + + Determines whether this instance and a specified , have the same value. + + The to compare to this instance. + true if the value of is the same as this instance; otherwise, false. If is null, returns false. + + + + Determines whether the specified string array and objects have the same values. + + The string array to compare. + The to compare. + true if the value of is the same as the value of ; otherwise, false. + + + + Determines whether the specified and string array objects have the same values. + + The to compare. + The string array to compare. + true if the value of is the same as the value of ; otherwise, false. + + + + Determines whether this instance and a specified string array have the same values. + + The string array to compare to this instance. + true if the value of is the same as this instance; otherwise, false. + + + + + + + Determines whether the specified and objects have different values. + + The to compare. + The to compare. + true if the value of is different to the value of ; otherwise, false. + + + + + + + Determines whether the specified and objects have different values. + + The to compare. + The to compare. + true if the value of is different to the value of ; otherwise, false. + + + + + + + Determines whether the specified and string array have different values. + + The to compare. + The string array to compare. + true if the value of is different to the value of ; otherwise, false. + + + + + + + Determines whether the specified string array and have different values. + + The string array to compare. + The to compare. + true if the value of is different to the value of ; otherwise, false. + + + + Determines whether the specified and , which must be a + , , or array of , have the same value. + + The to compare. + The to compare. + true if the object is equal to the ; otherwise, false. + + + + Determines whether the specified and , which must be a + , , or array of , have different values. + + The to compare. + The to compare. + true if the object is equal to the ; otherwise, false. + + + + Determines whether the specified , which must be a + , , or array of , and specified , have the same value. + + The to compare. + The to compare. + true if the object is equal to the ; otherwise, false. + + + + Determines whether the specified and object have the same values. + + The to compare. + The to compare. + true if the object is equal to the ; otherwise, false. + + + + Determines whether this instance and a specified object have the same value. + + An object to compare with this object. + true if the current object is equal to ; 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. + + + + + Enumerates the string values of a . + + + + + Instantiates an using a . + + The to enumerate. + + + + Advances the enumerator to the next element of the . + + if the enumerator was successfully advanced to the next element; if the enumerator has passed the end of the . + + + + Gets the element at the current position of the enumerator. + + + + + Releases all resources used by the . + + + + + Registers for a callback that will be invoked when the entry has changed. + MUST be set before the callback is invoked. + + The callback to invoke. + State to be passed into the callback. + The to invoke the callback with. + The action to execute when an is thrown. Should be used to set the IChangeToken's ActiveChangeCallbacks property to false. + The state to be passed into the action. + The registration. + + + + Get a pinnable reference to the builder. + Does not ensure there is a null char after + This overload is pattern matched in the C# 7.3+ compiler so you can omit + the explicit method call, and write eg "fixed (char* c = builder)" + + + + + Get a pinnable reference to the builder. + + Ensures that the builder has a null char after + + + Returns the underlying storage of the builder. + + + + Returns a span around the contents of the builder. + + Ensures that the builder has a null char after + + + + Resize the internal buffer either by doubling current buffer size or + by adding to + whichever is greater. + + + Number of chars requested beyond current position. + + + + Offset and length are out of bounds for the string or length is greater than the number of characters from index to the end of the string. + + + Offset and length are out of bounds for this StringSegment or length is greater than the number of characters to the end of this StringSegment. + + + Cannot change capacity after write started. + + + Not enough capacity to write '{0}' characters, only '{1}' left. + + + Entire reserved capacity was not used. Capacity: '{0}', written '{1}'. + + + + Attribute used to indicate a source generator should create a function for marshalling + arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time. + + + This attribute is meaningless if the source generator associated with it is not enabled. + The current built-in source generator only supports C# and only supplies an implementation when + applied to static, partial, non-generic methods. + + + + + Initializes a new instance of the . + + Name of the library containing the import. + + + + Gets the name of the library containing the import. + + + + + Gets or sets the name of the entry point to be called. + + + + + Gets or sets how to marshal string arguments to the method. + + + If this field is set to a value other than , + must not be specified. + + + + + Gets or sets the used to control how string arguments to the method are marshalled. + + + If this field is specified, must not be specified + or must be set to . + + + + + Gets or sets whether the callee sets an error (SetLastError on Windows or errno + on other platforms) before returning from the attributed method. + + + + + Specifies how strings should be marshalled for generated p/invokes + + + + + Indicates the user is suppling a specific marshaller in . + + + + + Use the platform-provided UTF-8 marshaller. + + + + + Use the platform-provided UTF-16 marshaller. + + + + Specifies that null is allowed as an input even if the corresponding type disallows it. + + + Specifies that null is disallowed as an input even if the corresponding type allows it. + + + Specifies that an output may be null even if the corresponding type disallows it. + + + Specifies that an output will not be null even if the corresponding type allows it. Specifies that an input argument was not null when the call returns. + + + Specifies that when a method returns , the parameter may be null even if the corresponding type disallows it. + + + Initializes the attribute with the specified return value condition. + + The return value condition. If the method returns this value, the associated parameter may be null. + + + + Gets the return value condition. + + + 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 the output will be non-null if the named parameter is non-null. + + + Initializes the attribute with the associated parameter name. + + The associated parameter name. The output will be non-null if the argument to the parameter specified is non-null. + + + + Gets the associated parameter name. + + + Applied to a method that will never return under any circumstance. + + + Specifies that the method will not return if the associated Boolean parameter is passed the specified value. + + + Initializes the attribute with the specified parameter value. + + 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. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values. + + + Initializes the attribute with a field or property member. + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the list of field and property members. + + The list of field and property members that are promised to be not-null. + + + + Gets field or property member names. + + + Specifies that the method or property will ensure that the listed field and property members have not-null values when returning with the specified return value condition. + + + Initializes the attribute with the specified return value condition and a field or property member. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The field or property member that is promised to be not-null. + + + + Initializes the attribute with the specified return value condition and list of field and property members. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + The list of field and property members that are promised to be not-null. + + + + Gets the return value condition. + + + Gets field or property member names. + + + diff --git a/Bin/Microsoft.ReportViewer.Common.dll b/Bin/Microsoft.ReportViewer.Common.dll index fe52fd9d4..f973fc006 100644 Binary files a/Bin/Microsoft.ReportViewer.Common.dll and b/Bin/Microsoft.ReportViewer.Common.dll differ diff --git a/Bin/Microsoft.ReportViewer.DataVisualization.dll b/Bin/Microsoft.ReportViewer.DataVisualization.dll index 5d65bb234..b1afd5feb 100644 Binary files a/Bin/Microsoft.ReportViewer.DataVisualization.dll and b/Bin/Microsoft.ReportViewer.DataVisualization.dll differ diff --git a/Bin/Microsoft.ReportViewer.Design.dll b/Bin/Microsoft.ReportViewer.Design.dll index a57d922e9..bd68579cc 100644 Binary files a/Bin/Microsoft.ReportViewer.Design.dll and b/Bin/Microsoft.ReportViewer.Design.dll differ diff --git a/Bin/Microsoft.ReportViewer.ProcessingObjectModel.dll b/Bin/Microsoft.ReportViewer.ProcessingObjectModel.dll index 4ca8a19ba..cf9c49d8b 100644 Binary files a/Bin/Microsoft.ReportViewer.ProcessingObjectModel.dll and b/Bin/Microsoft.ReportViewer.ProcessingObjectModel.dll differ diff --git a/Bin/Microsoft.ReportViewer.WebDesign.dll b/Bin/Microsoft.ReportViewer.WebDesign.dll index 84e0cda54..5b1021166 100644 Binary files a/Bin/Microsoft.ReportViewer.WebDesign.dll and b/Bin/Microsoft.ReportViewer.WebDesign.dll differ diff --git a/Bin/Microsoft.ReportViewer.WebForms.dll b/Bin/Microsoft.ReportViewer.WebForms.dll index 02196e68a..00e5a0ca4 100644 Binary files a/Bin/Microsoft.ReportViewer.WebForms.dll and b/Bin/Microsoft.ReportViewer.WebForms.dll differ diff --git a/Bin/Microsoft.ReportViewer.WinForms.dll b/Bin/Microsoft.ReportViewer.WinForms.dll index b5935735e..7e8f0ce6f 100644 Binary files a/Bin/Microsoft.ReportViewer.WinForms.dll and b/Bin/Microsoft.ReportViewer.WinForms.dll differ diff --git a/Bin/MimeKit.xml b/Bin/MimeKit.xml new file mode 100644 index 000000000..ef47db472 --- /dev/null +++ b/Bin/MimeKit.xml @@ -0,0 +1,57495 @@ + + + + MimeKit + + + + + A MIME message and entity parser. + + + A MIME parser is used to parse and + objects from arbitrary streams. + + + + + Asynchronously parse a list of headers from the stream. + + + Asynchronously parses a list of headers from the stream. + + The parsed list of headers. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Asynchronously parse an entity from the stream. + + + Asynchronously parses an entity from the stream. + + The parsed entity. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously parse a message from the stream. + + + Asynchronously parses a message from the stream. + + The parsed message. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the message. + + + An I/O error occurred. + + + + + Initialize a new instance of the class. + + + Creates a new that will parse the specified stream. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + + + + The stream to parse. + The format of the stream. + true if the stream is persistent; otherwise false. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new that will parse the specified stream. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The stream to parse. + true if the stream is persistent; otherwise false. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new that will parse the specified stream. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The parser options. + The stream to parse. + true if the stream is persistent; otherwise false. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new that will parse the specified stream. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The parser options. + The stream to parse. + The format of the stream. + true if the stream is persistent; otherwise false. + + is null. + -or- + is null. + + + + + Get or set the parser options. + + + Gets or sets the parser options. + + The parser options. + + + + Get a value indicating whether the parser has reached the end of the input stream. + + + Gets a value indicating whether the parser has reached the end of the input stream. + + + + + true if this parser has reached the end of the input stream; + otherwise, false. + + + + Get the current position of the parser within the stream. + + + Gets the current position of the parser within the stream. + + The stream offset. + + + + Get the most recent mbox marker offset. + + + Gets the most recent mbox marker offset. + + + + + The mbox marker offset. + + + + Get the most recent mbox marker. + + + Gets the most recent mbox marker. + + + + + The mbox marker. + + + + Set the stream to parse. + + + Sets the stream to parse. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The parser options. + The stream to parse. + The format of the stream. + true if the stream is persistent; otherwise false. + + is null. + -or- + is null. + + + + + Set the stream to parse. + + + Sets the stream to parse. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The parser options. + The stream to parse. + true if the stream is persistent; otherwise false. + + is null. + -or- + is null. + + + + + Set the stream to parse. + + + Sets the stream to parse. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The stream to parse. + The format of the stream. + true if the stream is persistent; otherwise false. + + is null. + + + + + Set the stream to parse. + + + Sets the stream to parse. + + The stream to parse. + The format of the stream. + + is null. + + + + + Set the stream to parse. + + + Sets the stream to parse. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The stream to parse. + true if the stream is persistent; otherwise false. + + is null. + + + + + An event signifying the beginning of a new has been encountered. + + + An event signifying the beginning of a new has been encountered. + + + + + + + + Invoked when the parser begins parsing a . + + + Invoked when the parser begins parsing a . + + The parsed state. + + + + An event signifying the end of a has been encountered. + + + An event signifying the end of a has been encountered. + + + + + + + + Invoked when the parser has completed parsing a . + + + Invoked when the parser has completed parsing a . + + The parsed state. + + + + An event signifying the beginning of a new has been encountered. + + + An event signifying the beginning of a new has been encountered. + + + + + + + + Invoked when the parser begins parsing a . + + + Invoked when the parser begins parsing a . + + The parsed state. + + + + An event signifying the end of a has been encountered. + + + An event signifying the end of a has been encountered. + + + + + + + + Invoked when the parser has completed parsing a . + + + Invoked when the parser has completed parsing a . + + The parsed state. + + + + This is a hack needed by the MessageDeliveryStatus.ParseStatusGroups() logic in order to work around an Office365 bug. + + The remainder of the parser's input stream (needed because the input stream may not be seekable). + + + + Parse a list of headers from the stream. + + + Parses a list of headers from the stream. + + The parsed list of headers. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Parse a single message/delivery-status status group from the stream. + + + Parses a single message/delivery-status status group from the stream. + + The parsed status group. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the status group. + + + An I/O error occurred. + + + + + Parse an entity from the stream. + + + Parses an entity from the stream. + + The parsed entity. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Parse a message from the stream. + + + Parses a message from the stream. + + + + + The parsed message. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the message. + + + An I/O error occurred. + + + + + Enumerate the messages in the stream. + + + This is mostly useful when parsing mbox-formatted streams. + + The enumerator. + + + + Enumerate the messages in the stream. + + + This is mostly useful when parsing mbox-formatted streams. + + The enumerator. + + + + A MIME message and entity reader. + + + provides forward-only, read-only access to MIME data in a stream. + + + + + Asynchronously read a block of headers from the stream. + + + Asynchronously reads a block of headers from the stream. + + An asynchronous task context. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously read an entity from the stream. + + + Asynchronously reads an entity from the stream. + + An asynchronous task context. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously read a message from the stream. + + + Asynchronously reads a message from the stream. + + An asynchronous task context. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the message. + + + An I/O error occurred. + + + + + Initialize a new instance of the class. + + + Creates a new that will parse the specified stream. + + The stream to parse. + The format of the stream. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new that will parse the specified stream. + + The parser options. + The stream to parse. + The format of the stream. + + is null. + -or- + is null. + + + + + Get or set the parser options. + + + Gets or sets the parser options. + + The parser options. + + + + Get a value indicating whether the parser has reached the end of the input stream. + + + Gets a value indicating whether the parser has reached the end of the input stream. + + true if this parser has reached the end of the input stream; + otherwise, false. + + + + Get the current position of the parser within the stream. + + + Gets the current position of the parser within the stream. + + The stream offset. + + + + Set the stream to parse. + + + Sets the stream to parse. + + The stream to parse. + The format of the stream. + + is null. + + + + + Called when an Mbox marker is encountered in the stream. + + + When the stream is specified to be in format, this method will be called whenever the parser encounters an Mbox marker. + It is not necessary to override this method unless it is desirable to track the offsets of mbox markers within a stream or to extract the mbox marker itself. + + The buffer containing the mbox marker. + The index denoting the starting position of the mbox marker within the buffer. + The length of the mbox marker within the buffer, in bytes. + The offset into the stream where the mbox marker begins. + The line number where the mbox marker exists within the stream. + The cancellation token. + + + + Called when an Mbox marker is encountered in the stream. + + + When the stream is specified to be in format, this method will be called whenever the parser encounters an Mbox marker. + It is not necessary to override this method unless it is desirable to track the offsets of mbox markers within a stream or to extract the mbox marker itself. + + An asynchronous task context. + The buffer containing the mbox marker. + The index denoting the starting position of the mbox marker within the buffer. + The length of the mbox marker within the buffer, in bytes. + The offset into the stream where the mbox marker begins. + The line number where the mbox marker exists within the stream. + The cancellation token. + + + + Called when the beginning of a list of headers is encountered in the stream. + + + Called when the beginning of a list of headers is encountered in the stream. + This method is always paired with a corresponding call to when the end of the list of headers are found. + + The offset into the stream where the headers begin. + The line number where the list of headers begin. + The cancellation token. + + + + Called when the beginning of a list of headers is encountered in the stream. + + + Called when the beginning of a list of headers is encountered in the stream. + This method is always paired with a corresponding call to when the end of the list of headers are found. + + An asynchronous task context. + The offset into the stream where the headers begin. + The line number where the list of headers begin. + The cancellation token. + + + + Called when a message or MIME part header is read from the stream. + + + This method will be called whenever a message or MIME part header is encountered within the stream. + + The header that was read from the stream. + The line number where the header exists within the stream. + The cancellation token. + + + + Called when a message or MIME part header is read from the stream. + + + This method will be called whenever a message or MIME part header is encountered within the stream. + + An asynchronous task context. + The header that was read from the stream. + The line number where the header exists within the stream. + The cancellation token. + + + + Called when the end of a list of headers is encountered in the stream. + + + Called when the end of a list of headers is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the headers began. + The line number where the list of headers began. + The offset into the stream where the list of headers ended. + The line number headers where the list of headers ended. + The cancellation token. + + + + Called when the end of a list of headers is encountered in the stream. + + + Called when the end of a list of headers is encountered in the stream. + This method is always paired with a corresponding call to . + + An asynchronous task context. + The offset into the stream where the headers began. + The line number where the list of headers began. + The offset into the stream where the list of headers ended. + The line number headers where the list of headers ended. + The cancellation token. + + + + Called when the beginning of a message is encountered in the stream. + + + Called when the beginning of a message is encountered in the stream. + This method is always paired with a corresponding call to when the end of the message is found. + + The offset into the stream where the message begins. + The line number where the message begins. + The cancellation token. + + + + Called when the beginning of a message is encountered in the stream. + + + Called when the beginning of a message is encountered in the stream. + This method is always paired with a corresponding call to when the end of the message is found. + + An asynchronous task context. + The offset into the stream where the message begins. + The line number where the message begins. + The cancellation token. + + + + Called when the end of a message is encountered in the stream. + + + Called when the end of a message is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the message began. + The line number where the message began. + The offset into the stream where the message headers ended and the content began. + The offset into the stream where the message ended. + The length of the message as measured in lines. + The cancellation token. + + + + Called when the end of a message is encountered in the stream. + + + Called when the end of a message is encountered in the stream. + This method is always paired with a corresponding call to . + + An asynchronous task context. + The offset into the stream where the message began. + The line number where the message began. + The offset into the stream where the message headers ended and the content began. + The offset into the stream where the message ended. + The length of the message as measured in lines. + The cancellation token. + + + + Called when the beginning of a MIME part is encountered in the stream. + + + Called when the beginning of a MIME part is encountered in the stream. + This method is always paired with a corresponding call to when the end of the MIME part is found. + + The parsed Content-Type header of the MIME part. + The offset into the stream where the MIME part begins. + The line number where the MIME part begins. + The cancellation token. + + + + Called when the beginning of a MIME part is encountered in the stream. + + + Called when the beginning of a MIME part is encountered in the stream. + This method is always paired with a corresponding call to when the end of the MIME part is found. + + An asynchronous task context. + The parsed Content-Type header of the MIME part. + The offset into the stream where the MIME part begins. + The line number where the MIME part begins. + The cancellation token. + + + + Called when the beginning of a MIME part's content is encountered in the stream. + + + Called when the beginning of a MIME part's content is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the MIME part content began. + The line number where the MIME part content began. + The cancellation token. + + + + Called when the beginning of a MIME part's content is encountered in the stream. + + + Called when the beginning of a MIME part's content is encountered in the stream. + This method is always paired with a corresponding call to . + + An asynchronous task context. + The offset into the stream where the MIME part content began. + The line number where the MIME part content began. + The cancellation token. + + + + Called when MIME part content is read from the stream. + + + Called when MIME part content is read from the stream. + + A buffer containing the MIME part content. + The index denoting the starting position of the content within the buffer. + The length of the content within the buffer, in bytes. + The cancellation token. + + + + Called when MIME part content is read from the stream. + + + Called when MIME part content is read from the stream. + + An asynchronous task context. + A buffer containing the MIME part content. + The index denoting the starting position of the content within the buffer. + The length of the content within the buffer, in bytes. + The cancellation token. + + + + Called when the end of a MIME part's content is encountered in the stream. + + + Called when the end of a MIME part's content is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the MIME part content began. + The line number where the MIME part content began. + The offset into the stream where the MIME part content ended. + The length of the MIME part content as measured in lines. + The new-line format of the content, if known. + The cancellation token. + + + + Called when the end of a MIME part's content is encountered in the stream. + + + Called when the end of a MIME part's content is encountered in the stream. + This method is always paired with a corresponding call to . + + An asynchronous task context. + The offset into the stream where the MIME part content began. + The line number where the MIME part content began. + The offset into the stream where the MIME part content ended. + The length of the MIME part content as measured in lines. + The new-line format of the content, if known. + The cancellation token. + + + + Called when the end of a MIME part is encountered in the stream. + + + Called when the end of a MIME part is encountered in the stream. + This method is always paired with a corresponding call to . + + The parsed Content-Type header of the MIME part. + The offset into the stream where the MIME part began. + The line number where the MIME part began. + The offset into the stream where the MIME part headers ended and the content began. + The offset into the stream where the MIME part ends. + The length of the MIME part as measured in lines. + The cancellation token. + + + + Called when the end of a MIME part is encountered in the stream. + + + Called when the end of a MIME part is encountered in the stream. + This method is always paired with a corresponding call to . + + An asynchronous task context. + The parsed Content-Type header of the MIME part. + The offset into the stream where the MIME part began. + The line number where the MIME part began. + The offset into the stream where the MIME part headers ended and the content began. + The offset into the stream where the MIME part ends. + The length of the MIME part as measured in lines. + The cancellation token. + + + + Called when the beginning of a message part is encountered in the stream. + + + Called when the beginning of a message part is encountered in the stream. + This method is always paired with a corresponding call to when the end of the message part is found. + + The parsed Content-Type header of the MIME part. + The offset into the stream where the message part begins. + The line number where the message part begins. + The cancellation token. + + + + Called when the beginning of a message part is encountered in the stream. + + + Called when the beginning of a message part is encountered in the stream. + This method is always paired with a corresponding call to when the end of the message part is found. + + An asynchronous task context. + The parsed Content-Type header of the MIME part. + The offset into the stream where the message part begins. + The line number where the message part begins. + The cancellation token. + + + + Called when the end of a message part is encountered in the stream. + + + Called when the end of a message part is encountered in the stream. + This method is always paired with a corresponding call to . + + The parsed Content-Type header of the MIME part. + The offset into the stream where the message part began. + The line number where the message part began. + The offset into the stream where the MIME part headers ended and the content began. + The offset into the stream where the MIME part ends. + The length of the MIME part as measured in lines. + The cancellation token. + + + + Called when the end of a message part is encountered in the stream. + + + Called when the end of a message part is encountered in the stream. + This method is always paired with a corresponding call to . + + An asynchronous task context. + The parsed Content-Type header of the MIME part. + The offset into the stream where the message part began. + The line number where the message part began. + The offset into the stream where the MIME part headers ended and the content began. + The offset into the stream where the MIME part ends. + The length of the MIME part as measured in lines. + The cancellation token. + + + + Called when the beginning of a multipart is encountered in the stream. + + + Called when the beginning of a multipart is encountered in the stream. + This method is always paired with a corresponding call to when the end of the multipart is found. + + The parsed Content-Type header of the multipart. + The offset into the stream where the multipart begins. + The line number where the multipart begins. + The cancellation token. + + + + Called when the beginning of a multipart is encountered in the stream. + + + Called when the beginning of a multipart is encountered in the stream. + This method is always paired with a corresponding call to when the end of the multipart is found. + + An asynchronous task context. + The parsed Content-Type header of the multipart. + The offset into the stream where the multipart begins. + The line number where the multipart begins. + The cancellation token. + + + + Called when a multipart boundary is encountered in the stream. + + + Called when a multipart boundary is encountered in the stream. + + The multipart boundary string. + The offset into the stream where the boundary marker began. + The offset into the stream where the boundary marker ended. + The line number where the boundary marker was found in the stream. + The cancellation token. + + + + Called when a multipart boundary is encountered in the stream. + + + Called when a multipart boundary is encountered in the stream. + + An asynchronous task context. + The multipart boundary string. + The offset into the stream where the boundary marker began. + The offset into the stream where the boundary marker ended. + The line number where the boundary marker was found in the stream. + The cancellation token. + + + + Called when a multipart end boundary is encountered in the stream. + + + Called when a multipart end boundary is encountered in the stream. + + The multipart boundary string. + The offset into the stream where the boundary marker began. + The offset into the stream where the boundary marker ended. + The line number where the boundary marker was found in the stream. + The cancellation token. + + + + Called when a multipart end boundary is encountered in the stream. + + + Called when a multipart end boundary is encountered in the stream. + + An asynchronous task context. + The multipart boundary string. + The offset into the stream where the boundary marker began. + The offset into the stream where the boundary marker ended. + The line number where the boundary marker was found in the stream. + The cancellation token. + + + + Called when the beginning of the preamble of a multipart is encountered in the stream. + + + Called when the beginning of the preamble of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the preamble began. + The line number where the preamble began. + The cancellation token. + + + + Called when the beginning of the preamble of a multipart is encountered in the stream. + + + Called when the beginning of the preamble of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + An asynchronous task context. + The offset into the stream where the preamble began. + The line number where the preamble began. + The cancellation token. + + + + Called when multipart preamble text is read from the stream. + + + Called when multipart preamble text is read from the stream. + + A buffer containing the multipart preamble text. + The index denoting the starting position of the content within the buffer. + The length of the content within the buffer, in bytes. + The cancellation token. + + + + Called when multipart preamble text is read from the stream. + + + Called when multipart preamble text is read from the stream. + + An asynchronous task context. + A buffer containing the multipart preamble text. + The index denoting the starting position of the content within the buffer. + The length of the content within the buffer, in bytes. + The cancellation token. + + + + Called when the end of the preamble of a multipart is encountered in the stream. + + + Called when the end of the preamble of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the multipart preamble began. + The line number where the multipart preamble began. + The offset into the stream where the multipart preamble ended. + The length of the multipart preamble as measured in lines. + The cancellation token. + + + + Called when the end of the preamble of a multipart is encountered in the stream. + + + Called when the end of the preamble of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + An asynchronous task context. + The offset into the stream where the multipart preamble began. + The line number where the multipart preamble began. + The offset into the stream where the multipart preamble ended. + The length of the multipart preamble as measured in lines. + The cancellation token. + + + + Called when the beginning of the epilogue of a multipart is encountered in the stream. + + + Called when the beginning of the epilogue of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the epilogue began. + The line number where the epilogue began. + The cancellation token. + + + + Called when the beginning of the epilogue of a multipart is encountered in the stream. + + + Called when the beginning of the epilogue of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + An asynchronous task context. + The offset into the stream where the epilogue began. + The line number where the epilogue began. + The cancellation token. + + + + Called when multipart epilogue text is read from the stream. + + + Called when multipart epilogue text is read from the stream. + + A buffer containing the multipart epilogue text. + The index denoting the starting position of the content within the buffer. + The length of the content within the buffer, in bytes. + The cancellation token. + + + + Called when multipart epilogue text is read from the stream. + + + Called when multipart epilogue text is read from the stream. + + An asynchronous task context. + A buffer containing the multipart epilogue text. + The index denoting the starting position of the content within the buffer. + The length of the content within the buffer, in bytes. + The cancellation token. + + + + Called when the end of the epilogue of a multipart is encountered in the stream. + + + Called when the end of the epilogue of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the multipart epilogue began. + The line number where the multipart epilogue began. + The offset into the stream where the multipart epilogue ended. + The length of the multipart epilogue as measured in lines. + The cancellation token. + + + + Called when the end of the epilogue of a multipart is encountered in the stream. + + + Called when the end of the epilogue of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + An asynchronous task context. + The offset into the stream where the multipart epilogue began. + The line number where the multipart epilogue began. + The offset into the stream where the multipart epilogue ended. + The length of the multipart epilogue as measured in lines. + The cancellation token. + + + + Called when the end of a multipart is encountered in the stream. + + + Called when the end of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + The parsed Content-Type header of the multipart. + The offset into the stream where the multipart began. + The line number where the multipart began. + The offset into the stream where the multipart headers ended and the content began. + The offset into the stream where the multipart ends. + The length of the multipart as measured in lines. + The cancellation token. + + + + Called when the end of a multipart is encountered in the stream. + + + Called when the end of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + An asynchronous task context. + The parsed Content-Type header of the multipart. + The offset into the stream where the multipart began. + The line number where the multipart began. + The offset into the stream where the multipart headers ended and the content began. + The offset into the stream where the multipart ends. + The length of the multipart as measured in lines. + The cancellation token. + + + + Read a block of headers from the stream. + + + Reads a block of headers from the stream. + + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Read an entity from the stream. + + + Reads an entity from the stream. + + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Read a message from the stream. + + + Reads a message from the stream. + + The parsed message. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the message. + + + An I/O error occurred. + + + + + A collection of attachments. + + + The is only used when building a message body with a . + + + + + + + + Initialize a new instance of the class. + + + Creates a new . + If is true, then the attachments + are treated as if they are linked to another . + + If set to true; the attachments are treated as linked resources. + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Get the number of attachments currently in the collection. + + + Indicates the number of attachments in the collection. + + The number of attachments. + + + + Get whther or not the collection is read-only. + + + A is never read-only. + + true if the collection is read only; otherwise, false. + + + + Get or set the at the specified index. + + + Gets or sets the at the specified index. + It is the responsibility of the caller to dispose the original entity at the specified . + + The attachment at the specified index. + The index. + + is null. + + + is out of range. + + + + + Add an attachment. + + + Adds the specified data as an attachment using the supplied Content-Type. + The file name parameter is used to set the Content-Location. + For a list of known mime-types and their associated file extensions, see + http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types + + The newly added attachment . + The name of the file. + The file data. + The mime-type of the file. + + is null. + -or- + is null. + -or- + is null. + + + The specified file path is empty. + + + + + Add an attachment. + + + Adds the specified data as an attachment using the supplied Content-Type. + The file name parameter is used to set the Content-Location. + For a list of known mime-types and their associated file extensions, see + http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types + + The newly added attachment . + The name of the file. + The content stream. + The mime-type of the file. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + The specified file path is empty. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously add an attachment. + + + Asynchronously adds the specified data as an attachment using the supplied Content-Type. + The file name parameter is used to set the Content-Location. + For a list of known mime-types and their associated file extensions, see + http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types + + The newly added attachment . + The name of the file. + The content stream. + The mime-type of the file. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + The specified file path is empty. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Add an attachment. + + + Adds the data as an attachment, using the specified file name for deducing + the mime-type by extension and for setting the Content-Location. + + The newly added attachment . + The name of the file. + The file data to attach. + + is null. + -or- + is null. + + + The specified file path is empty. + + + + + Add an attachment. + + + Adds the stream as an attachment, using the specified file name for deducing + the mime-type by extension and for setting the Content-Location. + + The newly added attachment . + The name of the file. + The content stream. + The cancellation token. + + is null. + -or- + is null. + + + The specified file path is empty. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously add an attachment. + + + Asynchronously adds the stream as an attachment, using the specified file name for deducing + the mime-type by extension and for setting the Content-Location. + + The newly added attachment . + The name of the file. + The content stream. + The cancellation token. + + is null. + -or- + is null. + + + The specified file path is empty. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Add an attachment. + + + Adds the specified file as an attachment using the supplied Content-Type. + For a list of known mime-types and their associated file extensions, see + http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types + + The newly added attachment . + The name of the file. + The mime-type of the file. + The cancellation token. + + is null. + -or- + is null. + + + The specified file path is empty. + + + The specified file could not be found. + + + The user does not have access to read the specified file. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously add an attachment. + + + Asynchronously adds the specified file as an attachment using the supplied Content-Type. + For a list of known mime-types and their associated file extensions, see + http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types + + The newly added attachment . + The name of the file. + The mime-type of the file. + The cancellation token. + + is null. + -or- + is null. + + + The specified file path is empty. + + + The specified file could not be found. + + + The user does not have access to read the specified file. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Add an attachment. + + + Adds the specified file as an attachment. + + + + + The newly added attachment . + The name of the file. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously add an attachment. + + + Asynchronously adds the specified file as an attachment. + + The newly added attachment . + The name of the file. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Add an attachment. + + + Adds the specified as an attachment. + + The attachment. + + is null. + + + + + Clear the attachment collection. + + + Removes all attachments from the collection. + + + + + Clear the attachment collection. + + + Removes all attachments from the collection, optionally disposing them in the process. + + true if all of the attachments should be disposed; otherwise, false. + + + + Check if the collection contains the specified attachment. + + + Determines whether or not the collection contains the specified attachment. + + true if the specified attachment exists; + otherwise false. + The attachment. + + is null. + + + + + Copy all of the attachments in the collection to an array. + + + Copies all of the attachments within the into the array, + starting at the specified array index. + + The array to copy the attachments to. + The index into the array. + + is null. + + + is out of range. + + + + + Get the index of the requested attachment, if it exists. + + + Finds the index of the specified attachment, if it exists. + + The index of the requested attachment; otherwise -1. + The attachment. + + is null. + + + + + Insert an attachment at the given index. + + + Inserts the attachment at the specified index. + + The index to insert the attachment. + The attachment. + + is null. + + + is out of range. + + + + + Remove an attachment. + + + Removes the specified attachment. + + true if the attachment was removed; otherwise false. + The attachment. + + is null. + + + + + Remove the attachment at the specified index. + + + Removes the attachment at the specified index. + It is the responsibility of the caller to dispose the entity at the specified . + + The index. + + is out of range. + + + + + Get an enumerator for the list of attachments. + + + Gets an enumerator for the list of attachments. + + The enumerator. + + + + Get an enumerator for the list of attachments. + + + Gets an enumerator for the list of attachments. + + The enumerator. + + + + A message body builder. + + + is a helper class for building common MIME body structures. + + + + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + + + + Get the attachments. + + + Represents a collection of file attachments that will be included in the message. + + + + + The attachments. + + + + Get the linked resources. + + + Linked resources are a special type of attachment which are linked to from the . + + + + + The linked resources. + + + + Get or set the text body. + + + Represents the plain-text formatted version of the message body. + + + + + The text body. + + + + Get or set the html body. + + + Represents the html formatted version of the message body and may link to any of the . + + + + + The html body. + + + + Construct the message body based on the text-based bodies, the linked resources, and the attachments. + + + Combines the , , , + and into the proper MIME structure suitable for display in many common + mail clients. + + + + + The message body. + + + + A class representing a Content-Disposition header value. + + + The Content-Disposition header is a way for the originating client to + suggest to the receiving client whether to present the part to the user + as an attachment or as part of the content (inline). + + + + + The attachment disposition. + + + Indicates that the should be treated as an attachment. + + + + + The form-data disposition. + + + Indicates that the should be treated as form data. + + + + + The inline disposition. + + + Indicates that the should be rendered inline. + + + + + Initialize a new instance of the class. + + + The disposition should either be + or . + + The disposition. + + is null. + + + is not "attachment" or "inline". + + + + + Initialize a new instance of the class. + + + This is identical to with a disposition + value of . + + + + + Get or set the disposition. + + + The disposition is typically either "attachment" or "inline". + + The disposition. + + is null. + + + is an invalid disposition value. + + + + + Get or set a value indicating whether the is an attachment. + + + A convenience property to determine if the entity should be considered an attachment or not. + + true if the is an attachment; otherwise, false. + + + + Get the list of parameters on the . + + + In addition to specifying whether the entity should be treated as an + attachment vs displayed inline, the Content-Disposition header may also + contain parameters to provide further information to the receiving client + such as the file attributes. + + + + + The parameters. + + + + Get or set the name of the file. + + + When set, this can provide a useful hint for a default file name for the + content when the user decides to save it to disk. + + + + + The name of the file. + + + + Get or set the creation-date parameter. + + + Refers to the date and time that the content file was created on the + originating system. This parameter serves little purpose and is + typically not used by mail clients. + + The creation date. + + + + Get or set the modification-date parameter. + + + Refers to the date and time that the content file was last modified on + the originating system. This parameter serves little purpose and is + typically not used by mail clients. + + The modification date. + + + + Get or set the read-date parameter. + + + Refers to the date and time that the content file was last read on the + originating system. This parameter serves little purpose and is typically + not used by mail clients. + + The read date. + + + + Get or set the size parameter. + + + When set, the size parameter typically refers to the original size of the + content on disk. This parameter is rarely used by mail clients as it serves + little purpose. + + The size. + + + + Clone the content disposition. + + + Clones the content disposition. + + The cloned content disposition.s + + + + Serialize the to a string, optionally encoding the parameters. + + + Creates a string-representation of the , + optionally encoding the parameters as they would be encoded for transport. + + The serialized string. + The formatting options. + The charset to be used when encoding the parameter values. + If set to true, the parameter values will be encoded. + + is null. + -or- + is null. + + + + + Serialize the to a string, optionally encoding the parameters. + + + Creates a string-representation of the , + optionally encoding the parameters as they would be encoded for transport. + + The serialized string. + The charset to be used when encoding the parameter values. + If set to true, the parameter values will be encoded. + + is null. + + + + + Serialize the to a string, optionally encoding the parameters. + + + Creates a string-representation of the , + optionally encoding the parameters as they would be encoded for transport. + + The serialized string. + If set to true, the parameter values will be encoded. + + + + Serialize the to a string. + + + Creates a string-representation of the . + + A that represents the current + . + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Disposition value from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + true if the disposition was successfully parsed; otherwise, false. + The parser options. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed disposition. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Disposition value from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + true if the disposition was successfully parsed; otherwise, false. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed disposition. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Disposition value from the supplied buffer starting at the specified index. + + true if the disposition was successfully parsed; otherwise, false. + The parser options. + The input buffer. + The starting index of the input buffer. + The parsed disposition. + + is null. + -or- + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Disposition value from the supplied buffer starting at the specified index. + + true if the disposition was successfully parsed; otherwise, false. + The input buffer. + The starting index of the input buffer. + The parsed disposition. + + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Disposition value from the specified buffer. + + true if the disposition was successfully parsed; otherwise, false. + The parser options. + The input buffer. + The parsed disposition. + + is null. + -or- + is null. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Disposition value from the specified buffer. + + true if the disposition was successfully parsed; otherwise, false. + The input buffer. + The parsed disposition. + + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a Content-Disposition value from the supplied text. + + true if the disposition was successfully parsed; otherwise, false. + The parser options. + The text to parse. + The parsed disposition. + + is null. + -or- + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a Content-Disposition value from the supplied text. + + true if the disposition was successfully parsed; otherwise, false. + The text to parse. + The parsed disposition. + + is null. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Disposition value from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + The parsed . + The parser options. + The input buffer. + The start index of the buffer. + The length of the buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + The could not be parsed. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Disposition value from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + The parsed . + The input buffer. + The start index of the buffer. + The length of the buffer. + + is null. + + + and do not specify + a valid range in the byte array. + + + The could not be parsed. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Disposition value from the supplied buffer starting at the specified index. + + The parsed . + The parser options. + The input buffer. + The start index of the buffer. + + is null. + -or- + is null. + + + is out of range. + + + The could not be parsed. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Disposition value from the supplied buffer starting at the specified index. + + The parsed . + The input buffer. + The start index of the buffer. + + is null. + + + is out of range. + + + The could not be parsed. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Disposition value from the supplied buffer. + + The parsed . + The parser options. + The input buffer. + + is null. + -or- + is null. + + + The could not be parsed. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Disposition value from the supplied buffer. + + The parsed . + The input buffer. + + is null. + + + The could not be parsed. + + + + + Parse the specified text into a new instance of the class. + + + Parses a Content-Disposition value from the specified text. + + The parsed . + The parser options. + The input text. + + is null. + -or- + is null. + + + The could not be parsed. + + + + + Parse the specified text into a new instance of the class. + + + Parses a Content-Disposition value from the specified text. + + The parsed . + The input text. + + is null. + + + The could not be parsed. + + + + + An enumeration of all supported content transfer encodings. + + + Some older mail software is unable to properly deal with + data outside of the ASCII range, so it is sometimes + necessary to encode the content of MIME entities. + + + + + + The default encoding (aka no encoding at all). + + + + + The 7bit content transfer encoding. This encoding should be restricted to textual content + in the US-ASCII range. + + + + + The 8bit content transfer encoding. This encoding should be restricted to textual content + outside of the US-ASCII range but may not be supported by all transport services such as + older SMTP servers that do not support the 8BITMIME extension. + + + + + The binary content transfer encoding. This encoding is simply unencoded binary data. Typically + not supported by standard message transport services such as SMTP. + + + + + The base64 content transfer encoding. This encoding is typically used for encoding binary data + or textual content in a largely 8bit charset encoding and is supported by all message transport + services. + + + + + The quoted-printable content transfer encoding. This encoding is used for textual content that + is in a charset that has a minority of characters outside of the US-ASCII range (such as + ISO-8859-1 and other single-byte charset encodings) and is supported by all message transport + services. + + + + + The uuencode content transfer encoding. This is an obsolete encoding meant for encoding binary + data and has largely been superseded by . + + + + + A class representing a Content-Type header value. + + + The Content-Type header is a way for the originating client to + suggest to the receiving client the mime-type of the content and, + depending on that mime-type, presentation options such as charset. + + + + + Initialize a new instance of the class. + + + Creates a new based on the media type and subtype provided. + + Media type. + Media subtype. + + is null. + -or- + is null. + + + + + Get or set the type of the media. + + + Represents the media type of the . Examples include + "text", "image", and "application". This string should + always be treated as case-insensitive. + + The type of the media. + + is null. + + + + + Get or set the media subtype. + + + Represents the media subtype of the . Examples include + "html", "jpeg", and "octet-stream". This string should + always be treated as case-insensitive. + + The media subtype. + + is null. + + + + + Get the list of parameters on the . + + + In addition to the media type and subtype, the Content-Type header may also + contain parameters to provide further hints to the receiving client as to + how to process or display the content. + + The parameters. + + + + Get or set the boundary parameter. + + + This is a special parameter on entities, designating to the + parser a unique string that should be considered the boundary marker for each sub-part. + + The boundary. + + + + Get or set the charset parameter. + + + Text-based entities will often include a charset parameter + so that the receiving client can properly render the text. + + The charset. + + + + Get or set the charset parameter as an . + + + Text-based entities will often include a charset parameter + so that the receiving client can properly render the text. + + The charset encoding. + + + + Get or set the format parameter. + + + The format parameter is typically use with text/plain + entities and will either have a value of "fixed" or "flowed". + + The charset. + + + + Get the simple mime-type. + + + Gets the simple mime-type. + + The mime-type. + + + + Get or set the name parameter. + + + The name parameter is a way for the originating client to suggest + to the receiving client a display-name for the content, which may + be used by the receiving client if it cannot display the actual + content to the user. + + The name. + + + + Clone the content type. + + + Clones the content type. + + The cloned content type. + + + + Check if the this instance of matches + the specified MIME media type and subtype. + + + If the specified or + are "*", they match anything. + + true if the matches the + provided media type and subtype. + The media type. + The media subtype. + + is null. + -or- + is null. + + + + + Serialize the to a string, optionally encoding the parameters. + + + Creates a string-representation of the , optionally encoding + the parameters as they would be encoded for transport. + + The serialized string. + The formatting options. + The charset to be used when encoding the parameter values. + If set to true, the parameter values will be encoded. + + is null. + -or- + is null. + + + + + Serialize the to a string, optionally encoding the parameters. + + + Creates a string-representation of the , optionally encoding + the parameters as they would be encoded for transport. + + The serialized string. + The charset to be used when encoding the parameter values. + If set to true, the parameter values will be encoded. + + is null. + + + + + Serialize the to a string, optionally encoding the parameters. + + + Creates a string-representation of the , optionally encoding + the parameters as they would be encoded for transport. + + The serialized string. + If set to true, the parameter values will be encoded. + + + + Serialize the to a string. + + + Creates a string-representation of the . + + A that represents the current + . + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Type value from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + true if the content type was successfully parsed; otherwise, false. + The parser options. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed content type. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Type value from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + true if the content type was successfully parsed; otherwise, false. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed content type. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Type value from the supplied buffer starting at the specified index. + + true if the content type was successfully parsed; otherwise, false. + The parser options. + The input buffer. + The starting index of the input buffer. + The parsed content type. + + is null. + -or- + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Type value from the supplied buffer starting at the specified index. + + true if the content type was successfully parsed; otherwise, false. + The input buffer. + The starting index of the input buffer. + The parsed content type. + + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Type value from the specified buffer. + + true if the content type was successfully parsed; otherwise, false. + The parser options. + The input buffer. + The parsed content type. + + is null. + -or- + is null. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a Content-Type value from the specified buffer. + + true if the content type was successfully parsed; otherwise, false. + The input buffer. + The parsed content type. + + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a Content-Type value from the specified text. + + true if the content type was successfully parsed; otherwise, false. + The parser options. + The text to parse. + The parsed content type. + + is null. + -or- + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a Content-Type value from the specified text. + + true if the content type was successfully parsed; otherwise, false. + The text to parse. + The parsed content type. + + is null. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Type value from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + The parsed . + The parser options. + The input buffer. + The start index of the buffer. + The length of the buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + The could not be parsed. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Type value from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + The parsed . + The input buffer. + The start index of the buffer. + The length of the buffer. + + is null. + + + and do not specify + a valid range in the byte array. + + + The could not be parsed. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Type value from the supplied buffer starting at the specified index. + + The parsed . + The parser options. + The input buffer. + The start index of the buffer. + + is null. + -or- + is null. + + + is out of range. + + + The could not be parsed. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Type value from the supplied buffer starting at the specified index. + + The parsed . + The input buffer. + The start index of the buffer. + + is null. + + + is out of range. + + + The could not be parsed. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Type value from the specified buffer. + + The parsed . + The parser options. + The input buffer. + + is null. + -or- + is null. + + + The could not be parsed. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses a Content-Type value from the specified buffer. + + The parsed . + The input buffer. + + is null. + + + The could not be parsed. + + + + + Parse the specified text into a new instance of the class. + + + Parses a Content-Type value from the specified text. + + The parsed . + The parser options. + The text. + + is null. + -or- + is null. + + + The could not be parsed. + + + + + Parse the specified text into a new instance of the class. + + + Parses a Content-Type value from the specified text. + + The parsed . + The text. + + is null. + + + The could not be parsed. + + + + + A MIME part with a Content-Type of application/pgp-encrypted. + + + An application/pgp-encrypted part will typically be the first child of + a part and contains only a Version + header. + + + + + Initialize a new instance of the + class based on the . + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new MIME part with a Content-Type of application/pgp-encrypted + and content matching "Version: 1\n". + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + A MIME part with a Content-Type of application/pgp-signature. + + + An application/pgp-signature part contains detatched pgp signature data + and is typically contained within a part. + To verify the signature, use the one of the + Verify + methods on the parent multipart/signed part. + + + + + Initialize a new instance of the + class based on the . + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the + class with a Content-Type of application/pgp-signature. + + + Creates a new MIME part with a Content-Type of application/pgp-signature + and the as its content. + + The content stream. + + is null. + + + does not support reading. + -or- + does not support seeking. + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + An S/MIME part with a Content-Type of application/pkcs7-mime. + + + An application/pkcs7-mime is an S/MIME part and may contain encrypted, + signed or compressed data (or any combination of the above). + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new MIME part with a Content-Type of application/pkcs7-mime + and the as its content. + Unless you are writing your own pkcs7 implementation, you'll probably + want to use the , + , and/or + method to create new instances + of this class. + + The S/MIME type. + The content stream. + + is null. + + + is not a valid value. + + + does not support reading. + -or- + does not support seeking. + + + + + Gets the value of the "smime-type" parameter. + + + Gets the value of the "smime-type" parameter. + + The value of the "smime-type" parameter. + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Decompress the compressed-data. + + + Decompresses the compressed-data using the specified . + + The decompressed . + The S/MIME context to use for decompressing. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "compressed-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decompress the compressed-data. + + + Asynchronously decompresses the compressed-data using the specified . + + The decompressed . + The S/MIME context to use for decompressing. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "compressed-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decompress the compressed-data. + + + Decompresses the compressed-data using the default . + + The decompressed . + The cancellation token. + + The "smime-type" parameter on the Content-Type header is not "compressed-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decompress the compressed-data. + + + Asynchronously decompresses the compressed-data using the default . + + The decompressed . + The cancellation token. + + The "smime-type" parameter on the Content-Type header is not "compressed-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decrypt the enveloped-data. + + + Decrypts the enveloped-data using the specified . + + The decrypted . + The S/MIME context to use for decrypting. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "enveloped-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decrypt the enveloped-data. + + + Asynchronously decrypts the enveloped-data using the specified . + + The decrypted . + The S/MIME context to use for decrypting. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "enveloped-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decrypt the enveloped-data. + + + Decrypts the enveloped-data using the default . + + The decrypted . + The cancellation token. + + The "smime-type" parameter on the Content-Type header is not "certs-only". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decrypt the enveloped-data. + + + Asynchronously decrypts the enveloped-data using the default . + + The decrypted . + The cancellation token. + + The "smime-type" parameter on the Content-Type header is not "certs-only". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Import the certificates contained in the application/pkcs7-mime content. + + + Imports the certificates contained in the application/pkcs7-mime content. + + The S/MIME context to import certificates into. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "certs-only". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously import the certificates contained in the application/pkcs7-mime content. + + + Asynchronously imports the certificates contained in the application/pkcs7-mime content. + + An asynchronous task context. + The S/MIME context to import certificates into. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "certs-only". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Verify the signed-data and return the unencapsulated . + + + Verifies the signed-data and returns the unencapsulated . + + The list of digital signatures. + The S/MIME context to use for verifying the signature. + The unencapsulated entity. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "signed-data". + + + The extracted content could not be parsed as a MIME entity. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Verifies the signed-data and returns the unencapsulated . + + + Verifies the signed-data using the default and returns the + unencapsulated . + + The list of digital signatures. + The unencapsulated entity. + The cancellation token. + + The "smime-type" parameter on the Content-Type header is not "signed-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Compress the specified entity. + + + Compresses the specified entity using the specified . + Most mail clients, even among those that support S/MIME, do not support compression. + + The compressed entity. + The S/MIME context to use for compressing. + The entity. + The cancellation token. + + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously compress the specified entity. + + + Asynchronously compresses the specified entity using the specified . + Most mail clients, even among those that support S/MIME, do not support compression. + + The compressed entity. + The S/MIME context to use for compressing. + The entity. + The cancellation token. + + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Compress the specified entity. + + + Compresses the specified entity using the default . + Most mail clients, even among those that support S/MIME, do not support compression. + + The compressed entity. + The entity. + The cancellation token. + + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously compress the specified entity. + + + Asynchronously compresses the specified entity using the default . + Most mail clients, even among those that support S/MIME, do not support compression. + + The compressed entity. + The entity. + The cancellation token. + + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Encrypt the specified entity. + + + Encrypts the entity to the specified recipients using the supplied . + + The encrypted entity. + The S/MIME context to use for encrypting. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously encrypt the specified entity. + + + Asynchronously encrypts the entity to the specified recipients using the supplied . + + The encrypted entity. + The S/MIME context to use for encrypting. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Encrypt the specified entity. + + + Encrypts the entity to the specified recipients using the default . + + The encrypted entity. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously encrypt the specified entity. + + + Asynchronously encrypts the entity to the specified recipients using the default . + + The encrypted entity. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Encrypt the specified entity. + + + Encrypts the entity to the specified recipients using the supplied . + + The encrypted entity. + The S/MIME context to use for encrypting. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + Valid certificates could not be found for one or more of the . + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously encrypt the specified entity. + + + Asynchronously encrypts the entity to the specified recipients using the supplied . + + The encrypted entity. + The S/MIME context to use for encrypting. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + Valid certificates could not be found for one or more of the . + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Encrypt the specified entity. + + + Encrypts the entity to the specified recipients using the default . + + The encrypted entity. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + + + Valid certificates could not be found for one or more of the . + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously encrypt the specified entity. + + + Asynchronously encrypts the entity to the specified recipients using the default . + + The encrypted entity. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + + + Valid certificates could not be found for one or more of the . + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign the specified entity. + + + Signs the entity using the supplied signer and . + For better interoperability with other mail clients, you should use + + instead as the multipart/signed format is supported among a much larger + subset of mail client software. + + The signed entity. + The S/MIME context to use for signing. + The signer. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign the specified entity. + + + Asynchronously signs the entity using the supplied signer and . + For better interoperability with other mail clients, you should use + + instead as the multipart/signed format is supported among a much larger + subset of mail client software. + + The signed entity. + The S/MIME context to use for signing. + The signer. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign the specified entity. + + + Signs the entity using the supplied signer and the default . + For better interoperability with other mail clients, you should use + + instead as the multipart/signed format is supported among a much larger + subset of mail client software. + + The signed entity. + The signer. + The entity. + The cancellation token. + + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign the specified entity. + + + Asynchronously signs the entity using the supplied signer and the default . + For better interoperability with other mail clients, you should use + + instead as the multipart/signed format is supported among a much larger + subset of mail client software. + + The signed entity. + The signer. + The entity. + The cancellation token. + + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign the specified entity. + + + Signs the entity using the supplied signer, digest algorithm and . + For better interoperability with other mail clients, you should use + + instead as the multipart/signed format is supported among a much larger + subset of mail client software. + + The signed entity. + The S/MIME context to use for signing. + The signer. + The digest algorithm to use for signing. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign the specified entity. + + + Asynchronously signs the entity using the supplied signer, digest algorithm and . + For better interoperability with other mail clients, you should use + + instead as the multipart/signed format is supported among a much larger + subset of mail client software. + + The signed entity. + The S/MIME context to use for signing. + The signer. + The digest algorithm to use for signing. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign the specified entity. + + + Signs the entity using the supplied signer, digest algorithm and the default + . + For better interoperability with other mail clients, you should use + + instead as the multipart/signed format is supported among a much larger + subset of mail client software. + + The signed entity. + The signer. + The digest algorithm to use for signing. + The entity. + The cancellation token. + + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign the specified entity. + + + Asynchronously signs the entity using the supplied signer, digest algorithm and the default + . + For better interoperability with other mail clients, you should use + + instead as the multipart/signed format is supported among a much larger + subset of mail client software. + + The signed entity. + The signer. + The digest algorithm to use for signing. + The entity. + The cancellation token. + + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign and encrypt the specified entity. + + + Signs entity using the supplied signer and then encrypts the result to the specified recipients. + + The signed and encrypted entity. + The S/MIME context to use for signing and encrypting. + The signer. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign and encrypt the specified entity. + + + Asynchronously signs entity using the supplied signer and then encrypts the result to the specified recipients. + + The signed and encrypted entity. + The S/MIME context to use for signing and encrypting. + The signer. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign and encrypt the specified entity. + + + Signs entity using the supplied signer and the default + and then encrypts the result to the specified recipients. + + The signed and encrypted entity. + The signer. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchroinously sign and encrypt the specified entity. + + + Asynchronously signs entity using the supplied signer and the default + and then encrypts the result to the specified recipients. + + The signed and encrypted entity. + The signer. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign and encrypt the specified entity. + + + Signs entity using the supplied signer and then encrypts the result to the specified recipients. + + The signed and encrypted entity. + The S/MIME context to use for signing and encrypting. + The signer. + The digest algorithm to use for signing. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + -or- + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign and encrypt the specified entity. + + + Asynchronously signs entity using the supplied signer and then encrypts the result to the specified recipients. + + The signed and encrypted entity. + The S/MIME context to use for signing and encrypting. + The signer. + The digest algorithm to use for signing. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + -or- + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign and encrypt the specified entity. + + + Signs entity using the supplied signer and the default + and then encrypts the result to the specified recipients. + + The signed and encrypted entity. + The signer. + The digest algorithm to use for signing. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + -or- + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign and encrypt the specified entity. + + + Asynchronously signs entity using the supplied signer and the default + and then encrypts the result to the specified recipients. + + The signed and encrypted entity. + The signer. + The digest algorithm to use for signing. + The recipients. + The entity. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + -or- + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + An S/MIME part with a Content-Type of application/pkcs7-signature. + + + An application/pkcs7-signature part contains detatched pkcs7 signature data + and is typically contained within a part. + To verify the signature, use one of the + Verify + methods on the parent multipart/signed part. + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the + class with a Content-Type of application/pkcs7-signature. + + + Creates a new MIME part with a Content-Type of application/pkcs7-signature + and the as its content. + + The content stream. + + is null. + + + does not support reading. + -or- + does not support seeking. + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + An ARC signer. + + + An ARC signer. + + + + + + + + Initialize a new instance of the class. + + + Creates a new . + + The domain that the signer represents. + The selector subdividing the domain. + The signature algorithm. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The signer's private key. + The domain that the signer represents. + The selector subdividing the domain. + The signature algorithm. + + is null. + -or- + is null. + -or- + is null. + + + is not a private key. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + The file containing the private key. + The domain that the signer represents. + The selector subdividing the domain. + The signature algorithm. + + is null. + -or- + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The file did not contain a private key. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + An I/O error occurred. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The stream containing the private key. + The domain that the signer represents. + The selector subdividing the domain. + The signature algorithm. + + is null. + -or- + is null. + -or- + is null. + + + The file did not contain a private key. + + + An I/O error occurred. + + + + + Generate an ARC-Authentication-Results header. + + + Generates an ARC-Authentication-Results header. + If the returned contains a + with a equal to "arc", then the + will be used as the cv= tag value + in the ARC-Seal header generated by the . + + + + + The format options. + The message to create the ARC-Authentication-Results header for. + The cancellation token. + The ARC-Authentication-Results header or null if the should not sign the message. + + + + Asynchronously generate an ARC-Authentication-Results header. + + + Asynchronously generates an ARC-Authentication-Results header. + If the returned contains a + with a equal to "arc", then the + will be used as the cv= tag value + in the ARC-Seal header generated by the . + + + + + The format options. + The message to create the ARC-Authentication-Results header for. + The cancellation token. + The ARC-Authentication-Results header or null if the should not sign the message. + + + + Get the timestamp value. + + + Gets the timestamp to use as the t= value in the ARC-Message-Signature and ARC-Seal headers. + + A value representing the timestamp value. + + + + Digitally sign and seal a message using ARC. + + + Digitally signs and seals a message using ARC. + + + + + The formatting options. + The message to sign. + The list of header fields to sign. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + One or more ARC headers either did not contain an instance tag or the instance tag was invalid. + + + + + Asynchronously digitally sign and seal a message using ARC. + + + Asynchronously digitally signs and seals a message using ARC. + + + + + An awaitable task. + The formatting options. + The message to sign. + The list of header fields to sign. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + One or more ARC headers either did not contain an instance tag or the instance tag was invalid. + + + + + Digitally sign and seal a message using ARC. + + + Digitally signs and seals a message using ARC. + + + + + The message to sign. + The list of header fields to sign. + The cancellation token. + + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + One or more ARC headers either did not contain an instance tag or the instance tag was invalid. + + + + + Asynchronously digitally sign and seal a message using ARC. + + + Asynchronously digitally signs and seals a message using ARC. + + + + + An awaitable task. + The message to sign. + The list of header fields to sign. + The cancellation token. + + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + One or more ARC headers either did not contain an instance tag or the instance tag was invalid. + + + + + Digitally sign and seal a message using ARC. + + + Digitally signs and seals a message using ARC. + + + + + The formatting options. + The message to sign. + The list of header fields to sign. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + One or more ARC headers either did not contain an instance tag or the instance tag was invalid. + + + + + Asynchronously digitally sign and seal a message using ARC. + + + Asynchronously digitally signs and seals a message using ARC. + + + + + An awaitable task. + The formatting options. + The message to sign. + The list of header fields to sign. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + One or more ARC headers either did not contain an instance tag or the instance tag was invalid. + + + + + Digitally sign and seal a message using ARC. + + + Digitally signs and seals a message using ARC. + + + + + The message to sign. + The list of header fields to sign. + The cancellation token. + + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + One or more ARC headers either did not contain an instance tag or the instance tag was invalid. + + + + + Asynchronously digitally sign and seal a message using ARC. + + + Asynchronously digitally signs and seals a message using ARC. + + + + + An awaitable task. + The message to sign. + The list of header fields to sign. + The cancellation token. + + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + One or more ARC headers either did not contain an instance tag or the instance tag was invalid. + + + + + An ARC signature validation result. + + + An ARC signature validation result. + + + + + + + + No signatures to validate. + + + + + The validation passed. + + + + + The validation failed. + + + + + An enumeration of possible ARC validation errors. + + + An enumeration of possible ARC validation errors. + + + + + No errors. + + + + + One or more duplicate ARC-Authentication-Results headers exist. + + + + + One or more duplicate ARC-Message-Signature headers exist. + + + + + One or more duplicate ARC-Seal headers exist. + + + + + One or more ARC-Authentication-Results headers are missing. + + + + + One or more ARC-Message-Signature headers are missing. + + + + + One or more ARC-Seal headers are missing. + + + + + One or more ARC-Authentication-Results headers could not be parsed. + + + + + One or more ARC-Message-Signature headers could not be parsed. + + + + + One or more ARC-Seal headers could not be parsed. + + + + + One or more ARC-Seal headers have an invalid cv value. + + + + + One or more ARC-Seal headers are missing a cv value. + + + + + Validation failed for the most recent ARC-Message-Signature header. + + + + + Validation failed for one or more of the ARC-Seal headers. + + + + + An ARC header validation result. + + + Represents an ARC header and its signature validation result. + + + + + + + + Initialize a new instance of the class. + + The ARC header. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The ARC header. + The signature validation result. + + is null. + + + + + Get the signature validation result. + + + Gets the signature validation result. + + The signature validation result. + + + + Get the ARC header. + + + Gets the ARC header. + + The ARC header. + + + + An ARC validation result. + + + Represents the results of ArcVerifier.Verify + or ArcVerifier.VerifyAsync. + If no ARC headers are found on the , then the result will be + and both and + will be null. + If ARC headers are found on the but could not be parsed, then the + result will be and both + and will be null. + + + + + + + + Initialize a new instance of the class. + + + Creates a new . + + The signature validation results of the entire chain. + The validation results for the ARC-Message-Signature header. + The validation results for the ARC-Seal headers. + + + + Get the validation results for the ARC-Message-Signature header. + + + Gets the validation results for the ARC-Message-Signature header. + + The validation results for the ARC-Message-Signature header or null + if the ARC-Message-Signature header was not found. + + + + Get the validation results for each of the ARC-Seal headers. + + + Gets the validation results for each of the ARC-Seal headers in + their instance order. + + The array of validation results for the ARC-Seal headers or null + if no ARC-Seal headers were found. + + + + Get the signature validation results of the entire chain. + + + Gets the signature validation results of the entire chain. + + + + + The signature validation results of the entire chain. + + + + Get the chain validation errors. + + + Gets the chain validation errors. + + The chain validation errors. + + + + An ARC verifier. + + + Validates Authenticated Received Chains. + + + + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + The public key locator. + + is null. + + + + + Verify the ARC signature chain. + + + Verifies the ARC signature chain. + + + + + The ARC validation result. + The formatting options. + The message to verify. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously verify the ARC signature chain. + + + Asynchronously verifies the ARC signature chain. + + + + + The ARC validation result. + The formatting options. + The message to verify. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Verify the ARC signature chain. + + + Verifies the ARC signature chain. + + + + + The ARC validation result. + The message to verify. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously verify the ARC signature chain. + + + Asynchronously verifies the ARC signature chain. + + + + + The ARC validation result. + The message to verify. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Extension methods for System.Security.Cryptography.AsymmetricAlgorithm. + + + Extension methods for System.Security.Cryptography.AsymmetricAlgorithm. + + + + + Convert an AsymmetricAlgorithm into a BouncyCastle AsymmetricKeyParameter. + + + Converts an AsymmetricAlgorithm into a BouncyCastle AsymmetricKeyParameter. + Currently, only RSA and DSA keys are supported. + + The Bouncy Castle AsymmetricKeyParameter. + The key. + + is null. + + + is an unsupported asymmetric algorithm. + + + + + Convert an AsymmetricAlgorithm into a BouncyCastle AsymmetricCipherKeyPair. + + + Converts an AsymmetricAlgorithm into a BouncyCastle AsymmetricCipherKeyPair. + Currently, only RSA and DSA keys are supported. + + The Bouncy Castle AsymmetricCipherKeyPair. + The key. + + is null. + + + is a public key. + + + is an unsupported asymmetric algorithm. + + + + + Convert a BouncyCastle AsymmetricKeyParameter into an AsymmetricAlgorithm. + + + Converts a BouncyCastle AsymmetricKeyParameter into an AsymmetricAlgorithm. + Currently, only RSA and DSA keys are supported. + + The AsymmetricAlgorithm. + The AsymmetricKeyParameter. + + is null. + + + is an unsupported asymmetric key parameter. + + + + + Convert a BouncyCastle AsymmetricCipherKeyPair into an AsymmetricAlgorithm. + + + Converts a BouncyCastle AsymmetricCipherKeyPair into an AsymmetricAlgorithm. + Currently, only RSA and DSA keys are supported. + + The AsymmetricAlgorithm. + The AsymmetricCipherKeyPair. + + is null. + + + is an unsupported asymmetric algorithm. + + + + + A parsed representation of the Authentication-Results header. + + + The Authentication-Results header is used with electronic mail messages to + indicate the results of message authentication efforts. Any receiver-side + software, such as mail filters or Mail User Agents (MUAs), can use this header + field to relay that information in a convenient and meaningful way to users or + to make sorting and filtering decisions. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The authentication service identifier. + + is null. + + + + + Get the authentication service identifier. + + + Gets the authentication service identifier. + The authentication service identifier is the authserv-id token + as defined in rfc7601. + + The authserv-id token. + + + + Get or set the instance value. + + + Gets or sets the instance value. + This value will only be set if the + represents an ARC-Authentication-Results header value. + + The instance. + + + + Get or set the Authentication-Results version. + + + Gets or sets the Authentication-Results version. + The version value is the authres-version token as defined in + rfc7601. + + The authres-version token. + + + + Get the list of authentication results. + + + Gets the list of authentication results. + + The list of authentication results. + + + + Serializes the to a string. + + + Creates a string-representation of the . + + The serialized string. + + + + Try to parse the given input buffer into a new instance. + + + Parses an Authentication-Results header value from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + true if the authentication results were successfully parsed; otherwise, false. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed authentication results. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses an Authentication-Results header value from the supplied buffer. + + true if the authentication results were successfully parsed; otherwise, false. + The input buffer. + The parsed authentication results. + + is null. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses an Authentication-Results header value from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + The parsed . + The input buffer. + The start index of the buffer. + The length of the buffer. + + is null. + + + and do not specify + a valid range in the byte array. + + + The could not be parsed. + + + + + Parse the specified input buffer into a new instance of the class. + + + Parses an Authentication-Results header value from the supplied buffer. + + The parsed . + The input buffer. + + is null. + + + The could not be parsed. + + + + + An authentication method results. + + + An authentication method results. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The method used for authentication. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The method used for authentication. + The result of the authentication method. + + is null. + -or- + is null. + + + + + Get the Office365 method-specific authserv-id. + + + Gets the Office365 method-specific authserv-id. + An authentication service identifier is the authserv-id token + as defined in rfc7601. + Instead of specifying a single authentication service identifier at the + beginning of the header value, Office365 seems to provide a different + authentication service identifier for each method. + + The authserv-id token. + + + + Get the authentication method. + + + Gets the authentication method. + + The authentication method. + + + + Get the authentication method version. + + + Gets the authentication method version. + + The authentication method version. + + + + Get the authentication method results. + + + Gets the authentication method results. + + The authentication method results. + + + + Get the comment regarding the authentication method result. + + + Gets the comment regarding the authentication method result. + + The comment regarding the authentication method result. + + + + Get the action taken for the authentication method result. + + + Gets the action taken for the authentication method result. + + The action taken for the authentication method result. + + + + Get the reason for the authentication method result. + + + Gets the reason for the authentication method result. + + The reason for the authentication method result. + + + + Get the properties used by the authentication method. + + + Gets the properties used by the authentication method. + + The properties used by the authentication method. + + + + Serializes the to a string. + + + Creates a string-representation of the . + + The serialized string. + + + + An authentication method property. + + + An authentication method property. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The property type. + The name of the property. + The value of the property. + true if the property value was originally quoted; otherwise, false. + + is null. + -or- + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The property type. + The name of the property. + The value of the property. + + is null. + -or- + is null. + -or- + is null. + + + + + Get the type of the property. + + + Gets the type of the property. + + The type of the property. + + + + Get the property name. + + + Gets the property name. + + The name of the property. + + + + Get the property value. + + + Gets the property value. + + The value of the property. + + + + Serializes the to a string. + + + Creates a string-representation of the . + + The serialized string. + + + + Extension methods for use with BouncyCastle X509Certificates. + + + Extension methods for use with BouncyCastle X509Certificates. + + + + + Convert a BouncyCastle certificate into an X509Certificate2. + + + Converts a BouncyCastle certificate into an X509Certificate2. + + The X509Certificate2. + The BouncyCastle certificate. + + is null. + + + + + Gets the issuer name info. + + + For a list of available identifiers, see . + + The issuer name info. + The certificate. + The name identifier. + + is null. + + + + + Gets the issuer name info. + + + For a list of available identifiers, see . + + The issuer name info. + The certificate. + The name identifier. + + is null. + + + + + Gets the common name of the certificate. + + + Gets the common name of the certificate. + + The common name. + The certificate. + + is null. + + + + + Gets the subject name of the certificate. + + + Gets the subject name of the certificate. + + The subject name. + The certificate. + + is null. + + + + + Gets the subject email address of the certificate. + + + The email address component of the certificate's Subject identifier is + sometimes used as a way of looking up certificates for a particular + user if a fingerprint is not available. + + The subject email address. + The certificate. + + is null. + + + + + Gets the fingerprint of the certificate. + + + A fingerprint is a SHA-1 hash of the raw certificate data and is often used + as a unique identifier for a particular certificate in a certificate store. + + The fingerprint. + The certificate. + + is null. + + + + + Gets the public key algorithm for the certificate. + + + Gets the public key algorithm for the ceretificate. + + The public key algorithm. + The certificate. + + is null. + + + + + Gets the key usage flags. + + + The X.509 Key Usage Flags are used to determine which operations a certificate + may be used for. + + The key usage flags. + The certificate. + + is null. + + + + + Get the encryption algorithms that can be used with an X.509 certificate. + + + Scans the X.509 certificate for the S/MIME capabilities extension. If found, + the supported encryption algorithms will be decoded and returned. + If no extension can be found, the + algorithm is returned. + + The encryption algorithms. + The X.509 certificate. + + is null. + + + + + A Secure MIME (S/MIME) cryptography context. + + + An abstract S/MIME context built around the BouncyCastle API. + + + + + Initialize a new instance of the class. + + + Creates a new + + + + + Initialize a new instance of the class. + + + Creates a new + + A secure pseudo-random number generator. + + is null. + + + + + Get the pseudo-random number generator. + + + Gets the pseudo-random number generator. + + The pseudo-random number generator. + + + + Get or set whether or not certificate revocation lists should be downloaded when verifying signatures. + + + Gets or sets whether or not certificate revocation lists should be downloaded when verifying + signatures. + If enabled, the will attempt to automatically download + Certificate Revocation Lists (CRLs) from the internet based on the CRL Distribution Point extension on + each certificate. + Enabling this feature opens the client up to potential privacy risks. An attacker + can generate a custom X.509 certificate containing a CRL Distribution Point or OCSP URL pointing to an + attacker-controlled server, thereby getting a notification when the user decrypts the message or verifies + its digital signature. + + true if CRLs should be downloaded automatically; otherwise, false. + + + + Get the X.509 certificate matching the specified selector. + + + Gets the first certificate that matches the specified selector. + This method is used when constructing a certificate chain if the S/MIME + signature does not include a signer's certificate. + + The certificate on success; otherwise null. + The search criteria for the certificate. + + + + Get the private key for the certificate matching the specified selector. + + + Gets the private key for the first certificate that matches the specified selector. + This method is used when signing or decrypting content. + + The private key on success; otherwise, null. + The search criteria for the private key. + + + + Get the trusted anchors. + + + A trusted anchor is a trusted root-level X.509 certificate, + generally issued by a certificate authority (CA). + This method is used to build a certificate chain while verifying + signed content. + + The trusted anchors. + + + + Get the intermediate certificates. + + + An intermediate certificate is any certificate that exists between the root + certificate issued by a Certificate Authority (CA) and the certificate at + the end of the chain. + This method is used to build a certificate chain while verifying + signed content. + + The intermediate certificates. + + + + Get the certificate revocation lists. + + + A Certificate Revocation List (CRL) is a list of certificate serial numbers issued + by a particular Certificate Authority (CA) that have been revoked, either by the CA + itself or by the owner of the revoked certificate. + + The certificate revocation lists. + + + + Get the date & time for the next scheduled certificate revocation list update for the specified issuer. + + + Gets the date & time for the next scheduled certificate revocation list update for the specified issuer. + + The date & time for the next update (in UTC). + The issuer. + + + + Get the for the specified mailbox. + + + Constructs a with the appropriate certificate and + for the specified mailbox. + If the mailbox is a , the + property will be used instead of + the mailbox address. + + A . + The mailbox. + + A certificate for the specified could not be found. + + + + + Get a collection of CmsRecipients for the specified mailboxes. + + + Gets a collection of CmsRecipients for the specified mailboxes. + + A . + The mailboxes. + + is null. + + + A certificate for one or more of the specified could not be found. + + + + + Get the for the specified mailbox. + + + Constructs a with the appropriate signing certificate + for the specified mailbox. + If the mailbox is a , the + property will be used instead of + the mailbox address for database lookups. + + A . + The mailbox. + The preferred digest algorithm. + + A certificate for the specified could not be found. + + + + + Updates the known S/MIME capabilities of the client used by the recipient that owns the specified certificate. + + + Updates the known S/MIME capabilities of the client used by the recipient that owns the specified certificate. + This method is called when decoding digital signatures that include S/MIME capabilities in the metadata, allowing custom + implementations to update the X.509 certificate records with the list of preferred encryption algorithms specified by the + sending client. + + The certificate. + The encryption algorithm capabilities of the client (in preferred order). + The timestamp. + + + + Sign and encapsulate the content using the specified signer. + + + Signs and encapsulates the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously signs and encapsulate the content using the specified signer. + + + Asynchronously signs and encapsulates the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign and encapsulate the content using the specified signer and digest algorithm. + + + Signs and encapsulates the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign and encapsulate the content using the specified signer and digest algorithm. + + + Asynchronously signs and encapsulates the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign the content using the specified signer. + + + Signs the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign the content using the specified signer. + + + Asynchronously signs the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign the content using the specified signer and digest algorithm. + + + Signs the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign the content using the specified signer and digest algorithm. + + + Asynchronously signs the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Build a certificate chain. + + + Builds a certificate chain for the provided certificate to include when signing. + This method is ideal for use with custom + implementations when it is desirable to include the certificate chain + in the signature. + + The certificate to build the chain for. + The certificate chain, including the specified certificate. + + + + Attempts to map a + to a . + + + Attempts to map a + to a . + + true if the algorithm identifier was successfully mapped; otherwise, false. + The algorithm identifier. + The encryption algorithm. + + is null. + + + + + Attempts to map a + to a . + + + Attempts to map a + to a . + + true if the algorithm identifier was successfully mapped; otherwise, false. + The algorithm identifier. + The encryption algorithm. + + is null. + + + + + Get the list of digital signatures. + + + Gets the list of digital signatures. + This method is useful to call from within any custom + Verify + method that you may implement in your own class. + + The digital signatures. + The CMS signed data parser. + Whether or not the operation should be done asynchronously. + The cancellation token. + + + + Verify the specified content using the detached signature data. + + + Verifies the specified content using the detached signature data. + + A list of the digital signatures. + The content. + The detached signature data. + The cancellation token. + + is null. + -or- + is null. + + + An error occurred in the cryptographic message syntax subsystem. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously verify the specified content using the detached signature data. + + + Verifies the specified content using the detached signature data. + + A list of the digital signatures. + The content. + The detached signature data. + The cancellation token. + + is null. + -or- + is null. + + + An error occurred in the cryptographic message syntax subsystem. + + + The operation was canceled via the cancellation token. + + + + + Verify the digital signatures of the specified signed data and extract the original content. + + + Verifies the digital signatures of the specified signed data and extracts the original content. + + The list of digital signatures. + The signed data. + The extracted MIME entity. + The cancellation token. + + is null. + + + The extracted content could not be parsed as a MIME entity. + + + An error occurred in the cryptographic message syntax subsystem. + + + The operation was canceled via the cancellation token. + + + + + Verify the digital signatures of the specified signed data and extract the original content. + + + Verifies the digital signatures of the specified signed data and extracts the original content. + + The extracted content stream. + The signed data. + The digital signatures. + The cancellation token. + + is null. + + + An error occurred in the cryptographic message syntax subsystem. + + + The operation was canceled via the cancellation token. + + + + + An RSA-OAEP aware recipient info generator. + + + + + Encrypt the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted content. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously encrypt the specified content for the specified recipients. + + + Asynchronously encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted content. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Encrypt the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + A certificate for one or more of the could not be found. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously encrypt the specified content for the specified recipients. + + + Asynchronously encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + A certificate for one or more of the could not be found. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decrypt the specified encryptedData. + + + Decrypts the specified encryptedData. + + The decrypted . + The encrypted data. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decrypt the specified encryptedData. + + + Asynchronously decrypts the specified encryptedData. + + The decrypted . + The encrypted data. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decrypt the specified encryptedData to an output stream. + + + Decrypts the specified encryptedData to an output stream. + + The encrypted data. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decrypt the specified encryptedData to an output stream. + + + Asynchronously decrypts the specified encryptedData to an output stream. + + An asynchronous task context. + The encrypted data. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Export the certificates for the specified mailboxes. + + + Exports the certificates for the specified mailboxes. + + A new instance containing + the exported keys. + The mailboxes. + The cancellation token. + + is null. + + + No mailboxes were specified. + + + The operation was canceled via the cancellation token. + + + A certificate for one or more of the could not be found. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously export the certificates for the specified mailboxes. + + + Asynchronously exports the certificates for the specified mailboxes. + + A new instance containing + the exported keys. + The mailboxes. + The cancellation token. + + is null. + + + No mailboxes were specified. + + + The operation was canceled via the cancellation token. + + + A certificate for one or more of the could not be found. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Releases all resources used by the object. + + Call when you are finished using the . The + method leaves the in an unusable state. After + calling , you must release all references to the so + the garbage collector can reclaim the memory that the was occupying. + + + + An exception that is thrown when a certificate could not be found for a specified mailbox. + + + An exception that is thrown when a certificate could not be found for a specified mailbox. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The serialization info. + The stream context. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The mailbox that could not be resolved to a valid certificate. + A message explaining the error. + + + + When overridden in a derived class, sets the + with information about the exception. + + + Sets the + with information about the exception. + + The serialization info. + The streaming context. + + is null. + + + + + Gets the mailbox address that could not be resolved to a certificate. + + + Gets the mailbox address that could not be resolved to a certificate. + + The mailbox address. + + + + An S/MIME recipient. + + + If the X.509 certificates are known for each of the recipients, you + may wish to use a as opposed to having + the do its own certificate + lookups for each . + + + + + Initialize a new instance of the class. + + + Creates a new based on the provided certificate. + If the X.509 certificate contains an S/MIME capability extension, the initial value of the + property will be set to whatever encryption algorithms are + defined by the S/MIME capability extension, otherwise int will be initialized to a list + containing only the Triple-Des encryption algorithm which should be safe to assume for all + modern S/MIME v3.x client implementations. + + The recipient's certificate. + The recipient identifier type. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new , loading the certificate from the specified stream. + If the X.509 certificate contains an S/MIME capability extension, the initial value of the + property will be set to whatever encryption algorithms are + defined by the S/MIME capability extension, otherwise int will be initialized to a list + containing only the Triple-Des encryption algorithm which should be safe to assume for all + modern S/MIME v3.x client implementations. + + The stream containing the recipient's certificate. + The recipient identifier type. + + is null. + + + The specified file does not contain a certificate. + + + An I/O error occurred. + + + + + Initialize a new instance of the class. + + + Creates a new , loading the certificate from the specified file. + If the X.509 certificate contains an S/MIME capability extension, the initial value of the + property will be set to whatever encryption algorithms are + defined by the S/MIME capability extension, otherwise int will be initialized to a list + containing only the Triple-Des encryption algorithm which should be safe to assume for all + modern S/MIME v3.x client implementations. + + The file containing the recipient's certificate. + The recipient identifier type. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The specified file does not contain a certificate. + + + An I/O error occurred. + + + + + Initialize a new instance of the class. + + + Creates a new based on the provided certificate. + If the X.509 certificate contains an S/MIME capability extension, the initial value of the + property will be set to whatever encryption algorithms are + defined by the S/MIME capability extension, otherwise int will be initialized to a list + containing only the Triple-Des encryption algorithm which should be safe to assume for all + modern S/MIME v3.x client implementations. + + The recipient's certificate. + The recipient identifier type. + + is null. + + + + + Gets the recipient's certificate. + + + The certificate is used for the purpose of encrypting data. + + The certificate. + + + + Gets the recipient identifier type. + + + Specifies how the certificate should be looked up on the recipient's end. + + The recipient identifier type. + + + + Gets or sets the known S/MIME encryption capabilities of the + recipient's mail client, in their preferred order. + + + Provides the with an array of + encryption algorithms that are known to be supported by the + recpipient's client software and should be in the recipient's + order of preference. + + The encryption algorithms. + + + + Get or set the RSA key encryption padding. + + + Gets or sets the padding to use for key encryption when + the 's public key is an RSA key. + + The encryption padding scheme. + + + + A collection of objects. + + + If the X.509 certificates are known for each of the recipients, you + may wish to use a as opposed to + using the methods that take a list of + objects. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Gets the number of recipients in the collection. + + + Indicates the number of recipients in the collection. + + The number of recipients in the collection. + + + + Get a value indicating whether the is read only. + + + A is never read-only. + + true if this instance is read only; otherwise, false. + + + + Adds the specified recipient. + + + Adds the specified recipient. + + The recipient. + + is null. + + + + + Clears the recipient collection. + + + Removes all of the recipients from the collection. + + + + + Checks if the collection contains the specified recipient. + + + Determines whether or not the collection contains the specified recipient. + + true if the specified recipient exists; + otherwise false. + The recipient. + + is null. + + + + + Copies all of the recipients in the to the specified array. + + + Copies all of the recipients within the into the array, + starting at the specified array index. + + The array. + The array index. + + is null. + + + is out of range. + + + + + Removes the specified recipient. + + + Removes the specified recipient. + + true if the recipient was removed; otherwise false. + The recipient. + + is null. + + + + + Gets an enumerator for the collection of recipients. + + + Gets an enumerator for the collection of recipients. + + The enumerator. + + + + Gets an enumerator for the collection of recipients. + + + Gets an enumerator for the collection of recipients. + + The enumerator. + + + + An S/MIME signer. + + + If the X.509 certificate is known for the signer, you may wish to use a + as opposed to having the + do its own certificate lookup for the signer's . + + + + + Initialize a new instance of the class. + + + The initial value of the will be set to + and both the + and properties + will be initialized to empty tables. + + + + + Initialize a new instance of the class. + + + The initial value of the will be set to + and both the + and properties + will be initialized to empty tables. + + The chain of certificates starting with the signer's certificate back to the root. + The signer's private key. + The scheme used for identifying the signer certificate. + + is null. + -or- + is null. + + + did not contain any certificates. + -or- + The certificate cannot be used for signing. + -or- + is not a private key. + + + + + Initialize a new instance of the class. + + + The initial value of the will + be set to and both the + and properties will be + initialized to empty tables. + + The signer's certificate. + The signer's private key. + The scheme used for identifying the signer certificate. + + is null. + -or- + is null. + + + cannot be used for signing. + -or- + is not a private key. + + + + + Initialize a new instance of the class. + + + Creates a new , loading the X.509 certificate and private key + from the specified stream. + The initial value of the will + be set to and both the + and properties will be + initialized to empty tables. + + The raw certificate and key data in pkcs12 format. + The password to unlock the stream. + The scheme used for identifying the signer certificate. + + is null. + -or- + is null. + + + does not contain a private key. + -or- + does not contain a certificate that could be used for signing. + + + An I/O error occurred. + + + + + Initialize a new instance of the class. + + + Creates a new , loading the X.509 certificate and private key + from the specified file. + The initial value of the will + be set to and both the + and properties will be + initialized to empty tables. + + The raw certificate and key data in pkcs12 format. + The password to unlock the stream. + The scheme used for identifying the signer certificate. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + -or- + does not contain a private key. + -or- + does not contain a certificate that could be used for signing. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + An I/O error occurred. + + + + + Initialize a new instance of the class. + + + The initial value of the will + be set to and both the + and properties will be + initialized to empty tables. + + The signer's certificate. + The scheme used for identifying the signer certificate. + + is null. + + + cannot be used for signing. + + + + + Get the signer's certificate. + + + The signer's certificate that contains a public key that can be used for + verifying the digital signature. + + The signer's certificate. + + + + Get the certificate chain. + + + Gets the certificate chain. + + The certificate chain. + + + + Get or set the digest algorithm. + + + Specifies which digest algorithm to use to generate the + cryptographic hash of the content being signed. + + The digest algorithm. + + + + Get the private key. + + + The private key used for signing. + + The private key. + + + + Get or set the RSA signature padding. + + + Gets or sets the signature padding to use for signing when + the is an RSA key. + + The signature padding scheme. + + + + Gets the signer identifier type. + + + Specifies how the certificate should be looked up on the recipient's end. + + The signer identifier type. + + + + Get or set the signed attributes. + + + A table of attributes that should be included in the signature. + + The signed attributes. + + + + Get or set the unsigned attributes. + + + A table of attributes that should not be signed in the signature, + but still included in transport. + + The unsigned attributes. + + + + An abstract cryptography context. + + + Generally speaking, applications should not use a + directly, but rather via higher level APIs such as , + and . + + + + + Initialize a new instance of the class. + + + Creates a new . + By default, only the 3DES encryption algorithm and the SHA-1 digest algorithm are enabled. + + + + + Get or set whether a should be prepared before signing. + + + Gets or sets whether a should be prepared before signing. + + true if a MimeEntity should be prepared before signing; otherwise, false. + + + + Get the signature protocol. + + + The signature protocol is used by + in order to determine what the protocol parameter of the Content-Type + header should be. + + The signature protocol. + + + + Get the encryption protocol. + + + The encryption protocol is used by + in order to determine what the protocol parameter of the Content-Type + header should be. + + The encryption protocol. + + + + Get the key exchange protocol. + + + The key exchange protocol is really only used for OpenPGP. + + The key exchange protocol. + + + + Get the preferred rank order for the encryption algorithms; from the most preferred to the least. + + + Gets the preferred rank order for the encryption algorithms; from the most preferred to the least. + + The preferred encryption algorithm ranking. + + + + Get the enabled encryption algorithms in ranked order. + + + Gets the enabled encryption algorithms in ranked order. + + The enabled encryption algorithms. + + + + Enable the encryption algorithm. + + + Enables the encryption algorithm. + + The encryption algorithm. + + + + Disable the encryption algorithm. + + + Disables the encryption algorithm. + + The encryption algorithm. + + + + Check whether the specified encryption algorithm is enabled. + + + Determines whether the specified encryption algorithm is enabled. + + true if the specified encryption algorithm is enabled; otherwise, false. + The encryption algorithm. + + + + Get the preferred rank order for the digest algorithms; from the most preferred to the least. + + + Gets the preferred rank order for the digest algorithms; from the most preferred to the least. + + The preferred encryption algorithm ranking. + + + + Get the enabled digest algorithms in ranked order. + + + Gets the enabled digest algorithms in ranked order. + + The enabled encryption algorithms. + + + + Enable the digest algorithm. + + + Enables the digest algorithm. + + The digest algorithm. + + + + Disable the digest algorithm. + + + Disables the digest algorithm. + + The digest algorithm. + + + + Check whether the specified digest algorithm is enabled. + + + Determines whether the specified digest algorithm is enabled. + + true if the specified digest algorithm is enabled; otherwise, false. + The digest algorithm. + + + + Check whether or not the specified protocol is supported by the . + + + Used in order to make sure that the protocol parameter value specified in either a multipart/signed + or multipart/encrypted part is supported by the supplied cryptography context. + + true if the protocol is supported; otherwise false + The protocol. + + is null. + + + + + Get the string name of the digest algorithm for use with the micalg parameter of a multipart/signed part. + + + Maps the to the appropriate string identifier + as used by the micalg parameter value of a multipart/signed Content-Type + header. + + The micalg value. + The digest algorithm. + + is out of range. + + + + + Get the digest algorithm from the micalg parameter value in a multipart/signed part. + + + Maps the micalg parameter value string back to the appropriate . + + The digest algorithm. + The micalg parameter value. + + is null. + + + + + Check whether or not a particular mailbox address can be used for signing. + + + Checks whether or not as particular mailbocx address can be used for signing. + + true if the mailbox address can be used for signing; otherwise, false. + The signer. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously check whether or not a particular mailbox address can be used for signing. + + + Checks whether or not as particular mailbocx address can be used for signing. + + true if the mailbox address can be used for signing; otherwise, false. + The signer. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Check whether or not the cryptography context can encrypt to a particular recipient. + + + Checks whether or not the cryptography context can be used to encrypt to a particular recipient. + + true if the cryptography context can be used to encrypt to the designated recipient; otherwise, false. + The recipient's mailbox address. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously check whether or not the cryptography context can encrypt to a particular recipient. + + + Checks whether or not the cryptography context can be used to encrypt to a particular recipient. + + true if the cryptography context can be used to encrypt to the designated recipient; otherwise, false. + The recipient's mailbox address. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Sign the content using the specified signer and digest algorithm. + + + Signs the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + + + Asynchronously sign the content using the specified signer and digest algorithm. + + + Asynchronously signs the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + + + Verify the specified content using the detached signatureData. + + + Verifies the specified content using the detached signatureData. + + A list of digital signatures. + The content. + The signature data. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously verify the specified content using the detached signatureData. + + + Verifies the specified content using the detached signatureData. + + A list of digital signatures. + The content. + The signature data. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Encrypt the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + + + Asynchronously encrypt the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + + + Decrypt the specified encryptedData. + + + Decrypts the specified encryptedData. + + The decrypted . + The encrypted data. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously decrypt the specified encryptedData. + + + Asynchronously decrypts the specified encryptedData. + + The decrypted . + The encrypted data. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Imports the public certificates or keys from the specified stream. + + + Imports the public certificates or keys from the specified stream. + + The raw certificate or key data. + The cancellation token. + + is null. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously imports the public certificates or keys from the specified stream. + + + Asynchronously imports the public certificates or keys from the specified stream. + + An asynchronous task context. + The raw certificate or key data. + The cancellation token. + + is null. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Exports the keys for the specified mailboxes. + + + Exports the keys for the specified mailboxes. + + A new instance containing the exported keys. + The mailboxes. + The cancellation token. + + is null. + + + was empty. + + + Exporting keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously exports the keys for the specified mailboxes. + + + Asynchronously exports the keys for the specified mailboxes. + + A new instance containing the exported keys. + The mailboxes. + The cancellation token. + + is null. + + + was empty. + + + Exporting keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Releases the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + Releases all resources used by the object. + + Call when you are finished using the . The + method leaves the in an unusable state. After + calling , you must release all references to the so + the garbage collector can reclaim the memory that the was occupying. + + + + Creates a new for the specified protocol. + + + Creates a new for the specified protocol. + The default types can over overridden by calling + the method with the preferred type. + + The for the protocol. + The protocol. + + is null. + + + There are no supported s that support + the specified . + + + + + Registers a default or . + + + Registers the specified type as the default or + . + + A custom subclass of or + . + + is null. + + + is not a subclass of + or . + -or- + does not have a parameterless constructor. + + + + + Registers a default factory. + + + Registers a factory that will return a new instance of the default . + + A factory that creates a new instance of . + + is null. + + + + + Registers a default factory. + + + Registers a factory that will return a new instance of the default . + + A factory that creates a new instance of . + + is null. + + + + + Useful extensions for working with System.Data types. + + + + + Creates a with the specified name and value and then adds it to the command's parameters. + + The database command. + The parameter name. + The parameter value. + + + + A default implementation that uses + an SQLite database as a certificate and private key store. + + + The default S/MIME context is designed to be usable on any platform + where there exists a .NET runtime by storing certificates, CRLs, and + (encrypted) private keys in a SQL database. + + + + + The default database path for certificates, private keys and CRLs. + + + On Microsoft Windows-based systems, this path will be something like C:\Users\UserName\AppData\Roaming\mimekit\smime.db. + On Unix systems such as Linux and Mac OS X, this path will be ~/.mimekit/smime.db. + + + + + Initialize a new instance of the class. + + + Allows the program to specify its own location for the SQLite database. If the file does not exist, + it will be created and the necessary tables and indexes will be constructed. + Requires linking with Mono.Data.Sqlite. + + The path to the SQLite database. + The password used for encrypting and decrypting the private keys. + + is null. + -or- + is null. + + + The specified file path is empty. + + + Mono.Data.Sqlite is not available. + + + The user does not have access to read the specified file. + + + An error occurred reading the file. + + + + + Initialize a new instance of the class. + + + Allows the program to specify its own location for the SQLite database. If the file does not exist, + it will be created and the necessary tables and indexes will be constructed. + Requires linking with Mono.Data.Sqlite. + + The path to the SQLite database. + The password used for encrypting and decrypting the private keys. + A secure pseudo-random number generator. + + is null. + -or- + is null. + -or- + is null. + + + The specified file path is empty. + + + Mono.Data.Sqlite is not available. + + + The user does not have access to read the specified file. + + + An error occurred reading the file. + + + + + Initialize a new instance of the class. + + + Allows the program to specify its own password for the default database. + Requires linking with Mono.Data.Sqlite. + + The password used for encrypting and decrypting the private keys. + + is null. + + + Mono.Data.Sqlite is not available. + + + The user does not have access to read the database at the default location. + + + An error occurred reading the database at the default location. + + + + + Initialize a new instance of the class. + + + Allows the program to specify its own password for the default database. + Requires linking with Mono.Data.Sqlite. + + The password used for encrypting and decrypting the private keys. + A secure pseudo-random number generator. + + is null. + -or- + is null. + + + Mono.Data.Sqlite is not available. + + + The user does not have access to read the database at the default location. + + + An error occurred reading the database at the default location. + + + + + Initialize a new instance of the class. + + + Not recommended for production use as the password to unlock the private keys is hard-coded. + Requires linking with Mono.Data.Sqlite. + + + Mono.Data.Sqlite is not available. + + + The user does not have access to read the database at the default location. + + + An error occurred reading the database at the default location. + + + + + Initialize a new instance of the class. + + + This constructor is useful for supplying a custom . + + The certificate database. + + is null. + + + + + Initialize a new instance of the class. + + + This constructor is useful for supplying a custom . + + The certificate database. + A secure pseudo-random number generator. + + is null. + -or- + is null. + + + + + Check whether or not a particular mailbox address can be used for signing. + + + Checks whether or not as particular mailbocx address can be used for signing. + + true if the mailbox address can be used for signing; otherwise, false. + The signer. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Check whether or not the cryptography context can encrypt to a particular recipient. + + + Checks whether or not the cryptography context can be used to encrypt to a particular recipient. + + true if the cryptography context can be used to encrypt to the designated recipient; otherwise, false. + The recipient's mailbox address. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Gets the X.509 certificate matching the specified selector. + + + Gets the first certificate that matches the specified selector. + + The certificate on success; otherwise null. + The search criteria for the certificate. + + + + Gets the private key for the certificate matching the specified selector. + + + Gets the private key for the first certificate that matches the specified selector. + + The private key on success; otherwise null. + The search criteria for the private key. + + + + Gets the trusted anchors. + + + A trusted anchor is a trusted root-level X.509 certificate, + generally issued by a Certificate Authority (CA). + + The trusted anchors. + + + + Gets the intermediate certificates. + + + An intermediate certificate is any certificate that exists between the root + certificate issued by a Certificate Authority (CA) and the certificate at + the end of the chain. + + The intermediate certificates. + + + + Gets the certificate revocation lists. + + + A Certificate Revocation List (CRL) is a list of certificate serial numbers issued + by a particular Certificate Authority (CA) that have been revoked, either by the CA + itself or by the owner of the revoked certificate. + + The certificate revocation lists. + + + + Get the date & time for the next scheduled certificate revocation list update for the specified issuer. + + + Gets the date & time for the next scheduled certificate revocation list update for the specified issuer. + + The date & time for the next update (in UTC). + The issuer. + + + + Gets the for the specified mailbox. + + + Constructs a with the appropriate certificate and + for the specified mailbox. + If the mailbox is a , the + property will be used instead of + the mailbox address for database lookups. + + A . + The recipient's mailbox address. + + A certificate for the specified could not be found. + + + + + Gets the for the specified mailbox. + + + Constructs a with the appropriate signing certificate + for the specified mailbox. + If the mailbox is a , the + property will be used instead of + the mailbox address for database lookups. + + A . + The signer's mailbox address. + The preferred digest algorithm. + + A certificate for the specified could not be found. + + + + + Updates the known S/MIME capabilities of the client used by the recipient that owns the specified certificate. + + + Updates the known S/MIME capabilities of the client used by the recipient that owns the specified certificate. + + The certificate. + The encryption algorithm capabilities of the client (in preferred order). + The timestamp in coordinated universal time (UTC). + + + + Import a certificate. + + + Imports the specified certificate into the database. + + The certificate. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Import a certificate. + + + Imports a certificate. + + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Imports a certificate revocation list. + + + Imports the specified certificate revocation list. + + The certificate revocation list. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Imports certificates and keys from a pkcs12-encoded stream. + + + Imports all of the certificates and keys from the pkcs12-encoded stream. + + The raw certificate and key data. + The password to unlock the data. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously imports certificates and keys from a pkcs12-encoded stream. + + + Asynchronously imports all of the certificates and keys from the pkcs12-encoded stream. + + An asynchronous task context. + The raw certificate and key data. + The password to unlock the data. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Import a certificate. + + + Imports the certificate. + If the certificate already exists in the database and is true, + then the IsTrusted state is updated otherwise the certificate is added to the database with the + specified trust. + + The certificate. + true if the certificate is trusted; otherwise, false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously import a certificate. + + + Asynchronously imports the certificate. + If the certificate already exists in the database and is true, + then the IsTrusted state is updated otherwise the certificate is added to the database with the + specified trust. + + An asynchronous task context. + The certificate. + true if the certificate is trusted; otherwise, false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Import a DER-encoded certificate stream. + + + Imports the certificate(s). + + The raw certificate(s). + true if the certificates are trusted; othewrwise, false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously import a DER-encoded certificate stream. + + + Asynchronously imports the certificate(s). + + An asynchronous task context. + The raw certificate(s). + true if the certificates are trusted; othewrwise, false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Releases the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + A digest algorithm. + + + Digest algorithms are secure hashing algorithms that are used + to generate unique fixed-length signatures for arbitrary data. + The most commonly used digest algorithms are currently MD5 + and SHA-1, however, MD5 was successfully broken in 2008 and should + be avoided. In late 2013, Microsoft announced that they would be + retiring their use of SHA-1 in their products by 2016 with the + assumption that its days as an unbroken digest algorithm were + numbered. It is speculated that the SHA-1 digest algorithm will + be vulnerable to collisions, and thus no longer considered secure, + by 2018. + Microsoft and other vendors plan to move to the SHA-2 suite of + digest algorithms which includes the following 4 variants: SHA-224, + SHA-256, SHA-384, and SHA-512. + + + + + No digest algorithm specified. + + + + + The MD5 digest algorithm. + + + + + The SHA-1 digest algorithm. + + + + + The Ripe-MD/160 digest algorithm. + + + + + The double-SHA digest algorithm. + + + + + The MD2 digest algorithm. + + + + + The TIGER/192 digest algorithm. + + + + + The HAVAL 5-pass 160-bit digest algorithm. + + + + + The SHA-256 digest algorithm. + + + + + The SHA-384 digest algorithm. + + + + + The SHA-512 digest algorithm. + + + + + The SHA-224 digest algorithm. + + + + + The MD4 digest algorithm. + + + + + A collection of digital signatures. + + + When verifying a digitally signed MIME part such as a + or a , you will get back a collection of + digital signatures. Typically, a signed message will only have a single signature + (created by the sender of the message), but it is possible for there to be + multiple signatures. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The signatures. + + + + An exception that is thrown when an error occurrs in . + + + For more information about the error condition, check the property. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The serialization info. + The stream context. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The key identifier. + The error message. + The inner exception. + + + + Initialize a new instance of the class. + + + Creates a new . + + The key identifier. + The error message. + + + + Initialize a new instance of the class. + + + Creates a new . + + The error message. + The inner exception. + + + + Initialize a new instance of the class. + + + Creates a new . + + The error message. + + + + When overridden in a derived class, sets the + with information about the exception. + + + Sets the + with information about the exception. + + The serialization info. + The streaming context. + + is null. + + + + + Get the key identifier, if available. + + + Gets the key identifier, if available. + + The key identifier. + + + + A base implementation for DKIM body filters. + + + A base implementation for DKIM body filters. + + + + + Get or set whether the last filtered character was a newline. + + + Gets or sets whether the last filtered character was a newline. + + + + + Get or set whether the current line is empty. + + + Gets or sets whether the current line is empty. + + + + + Get or set the number of consecutive empty lines encountered. + + + Gets or sets the number of consecutive empty lines encountered. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + A DKIM canonicalization algorithm. + + + Empirical evidence demonstrates that some mail servers and relay systems + modify email in transit, potentially invalidating a signature. There are two + competing perspectives on such modifications. For most signers, mild modification + of email is immaterial to the authentication status of the email. For such signers, + a canonicalization algorithm that survives modest in-transit modification is + preferred. + Other signers demand that any modification of the email, however minor, + result in a signature verification failure. These signers prefer a canonicalization + algorithm that does not tolerate in-transit modification of the signed email. + + + + + + + + The simple canonicalization algorithm tolerates almost no modification + by mail servers while the message is in-transit. + + + + + The relaxed canonicalization algorithm tolerates common modifications + by mail servers while the message is in-transit such as whitespace + replacement and header field line rewrapping. + + + + + A DKIM hash stream. + + + A DKIM hash stream. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The signature algorithm. + The max length of data to hash. + + + + Generate the hash. + + + Generates the hash. + + The hash. + + + + Checks whether or not the stream supports reading. + + + A is not readable. + + true if the stream supports reading; otherwise, false. + + + + Checks whether or not the stream supports writing. + + + A is always writable. + + true if the stream supports writing; otherwise, false. + + + + Checks whether or not the stream supports seeking. + + + A is not seekable. + + true if the stream supports seeking; otherwise, false. + + + + Checks whether or not reading and writing to the stream can timeout. + + + Writing to a cannot timeout. + + true if reading and writing to the stream can timeout; otherwise, false. + + + + Gets the length of the stream, in bytes. + + + The length of a indicates the + number of bytes that have been written to it. + + The length of the stream in bytes. + + The stream has been disposed. + + + + + Gets or sets the current position within the stream. + + + Since it is possible to seek within a , + it is possible that the position will not always be identical to the + length of the stream, but typically it will be. + + The position of the stream. + + An I/O error occurred. + + + The stream does not support seeking. + + + The stream has been disposed. + + + + + Reads a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reading from a is not supported. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many + bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + + The stream has been disposed. + + + The stream does not support reading. + + + + + Writes a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Increments the property by the number of bytes written. + If the updated position is greater than the current length of the stream, then + the property will be updated to be identical to the + position. + + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Sets the position within the current stream. + + + Updates the within the stream. + + The new position within the stream. + The offset into the stream relative to the . + The origin to seek from. + + is not a valid . + + + The stream has been disposed. + + + + + Clears all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + Since a does not actually do anything other than + count bytes, this method is a no-op. + + + The stream has been disposed. + + + + + Sets the length of the stream. + + + Sets the to the specified value and updates + to the specified value if (and only if) + the current position is greater than the new length value. + + The desired length of the stream in bytes. + + is out of range. + + + The stream has been disposed. + + + + + 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 the unmanaged resources. + + + + A base class for implemnentations of . + + + The class provides a helpful + method for parsing DNS TXT records in order to extract the public key. + + + + + + + + + + + Get the public key from a DNS TXT record. + + + Gets the public key from a DNS TXT record. + + The DNS TXT record. + The public key. + + The is null. + + + There was an error parsing the DNS TXT record. + + + + + Locate and retrieve the public key for the given domain and selector. + + + Locates and retrieves the public key for the given domain and selector. + + + + + + + + + + The public key. + A colon-separated list of query methods used to retrieve the public key. The default is "dns/txt". + The domain. + The selector. + The cancellation token. + + + + Asynchronously locate and retrieve the public key for the given domain and selector. + + + Locates and retrieves the public key for the given domain and selector. + + + + + + + + + + The public key. + A colon-separated list of query methods used to retrieve the public key. The default is "dns/txt". + The domain. + The selector. + The cancellation token. + + + + A filter for the DKIM relaxed body canonicalization. + + + A filter for the DKIM relaxed body canonicalization. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Resets the filter. + + + Resets the filter. + + + + + A DKIM signature algorithm. + + + A DKIM signature algorithm. + + + + + + + + The RSA-SHA1 signature algorithm. + + + + + The RSA-SHA256 signature algorithm. + + + + + The Ed25519-SHA256 signature algorithm. + + + + + A DKIM signature stream. + + + A DKIM signature stream. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The digest signer. + + is null. + + + + + Get the digest signer. + + + Gets the digest signer. + + The signer. + + + + Generate the signature. + + + Generates the signature. + + The signature. + + + + Verify the DKIM signature. + + + Verifies the DKIM signature. + + true if signature is valid; otherwise, false. + The base64 encoded DKIM signature from the b= parameter. + + is null. + + + + + Checks whether or not the stream supports reading. + + + A is not readable. + + true if the stream supports reading; otherwise, false. + + + + Checks whether or not the stream supports writing. + + + A is always writable. + + true if the stream supports writing; otherwise, false. + + + + Checks whether or not the stream supports seeking. + + + A is not seekable. + + true if the stream supports seeking; otherwise, false. + + + + Checks whether or not reading and writing to the stream can timeout. + + + Writing to a cannot timeout. + + true if reading and writing to the stream can timeout; otherwise, false. + + + + Gets the length of the stream, in bytes. + + + The length of a indicates the + number of bytes that have been written to it. + + The length of the stream in bytes. + + The stream has been disposed. + + + + + Gets or sets the current position within the stream. + + + Since it is possible to seek within a , + it is possible that the position will not always be identical to the + length of the stream, but typically it will be. + + The position of the stream. + + An I/O error occurred. + + + The stream does not support seeking. + + + The stream has been disposed. + + + + + Reads a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reading from a is not supported. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many + bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + + The stream has been disposed. + + + The stream does not support reading. + + + + + Writes a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Increments the property by the number of bytes written. + If the updated position is greater than the current length of the stream, then + the property will be updated to be identical to the + position. + + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Sets the position within the current stream. + + + Updates the within the stream. + + The new position within the stream. + The offset into the stream relative to the . + The origin to seek from. + + is not a valid . + + + The stream has been disposed. + + + + + Clears all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + Since a does not actually do anything other than + count bytes, this method is a no-op. + + + The stream has been disposed. + + + + + Sets the length of the stream. + + + Sets the to the specified value and updates + to the specified value if (and only if) + the current position is greater than the new length value. + + The desired length of the stream in bytes. + + is out of range. + + + The stream has been disposed. + + + + + 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 the unmanaged resources. + + + + A DKIM signer. + + + A DKIM signer. + + + + + + + + Initialize a new instance of the class. + + + Creates a new . + Due to the recognized weakness of the SHA-1 hash algorithm + and the wide availability of the SHA-256 hash algorithm (it has been a required + part of DKIM since it was originally standardized in 2007), it is recommended + that NOT be used. + + The domain that the signer represents. + The selector subdividing the domain. + The signature algorithm. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + Due to the recognized weakness of the SHA-1 hash algorithm + and the wide availability of the SHA-256 hash algorithm (it has been a required + part of DKIM since it was originally standardized in 2007), it is recommended + that NOT be used. + + The signer's private key. + The domain that the signer represents. + The selector subdividing the domain. + The signature algorithm. + + is null. + -or- + is null. + -or- + is null. + + + is not a private key. + + + + + Initialize a new instance of the class. + + + Creates a new . + Due to the recognized weakness of the SHA-1 hash algorithm + and the wide availability of the SHA-256 hash algorithm (it has been a required + part of DKIM since it was originally standardized in 2007), it is recommended + that NOT be used. + + + + + The file containing the private key. + The domain that the signer represents. + The selector subdividing the domain. + The signature algorithm. + + is null. + -or- + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The file did not contain a private key. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + An I/O error occurred. + + + + + Initialize a new instance of the class. + + + Creates a new . + Due to the recognized weakness of the SHA-1 hash algorithm + and the wide availability of the SHA-256 hash algorithm (it has been a required + part of DKIM since it was originally standardized in 2007), it is recommended + that NOT be used. + + The stream containing the private key. + The domain that the signer represents. + The selector subdividing the domain. + The signature algorithm. + + is null. + -or- + is null. + -or- + is null. + + + The file did not contain a private key. + + + An I/O error occurred. + + + + + Get or set the agent or user identifier. + + + Gets or sets the agent or user identifier. + + + + + The agent or user identifier. + + + + Get or set the public key query method. + + + Gets or sets the public key query method. + The value should be a colon-separated list of query methods used to + retrieve the public key (plain-text; OPTIONAL, default is "dns/txt"). Each + query method is of the form "type[/options]", where the syntax and + semantics of the options depend on the type and specified options. + + + + + The public key query method. + + + + Get the timestamp value. + + + Gets the timestamp to use as the t= value in the DKIM-Signature header. + + A value representing the timestamp value. + + + + Digitally sign the message using a DomainKeys Identified Mail (DKIM) signature. + + + Digitally signs the message using a DomainKeys Identified Mail (DKIM) signature. + + + + + The formatting options. + The message to sign. + The list of header fields to sign. + + is null. + -or- + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + + + Digitally sign the message using a DomainKeys Identified Mail (DKIM) signature. + + + Digitally signs the message using a DomainKeys Identified Mail (DKIM) signature. + + + + + The message to sign. + The headers to sign. + + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + + + Digitally sign the message using a DomainKeys Identified Mail (DKIM) signature. + + + Digitally signs the message using a DomainKeys Identified Mail (DKIM) signature. + + + + + The formatting options. + The message to sign. + The list of header fields to sign. + + is null. + -or- + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + + + Digitally sign the message using a DomainKeys Identified Mail (DKIM) signature. + + + Digitally signs the message using a DomainKeys Identified Mail (DKIM) signature. + + + + + The message to sign. + The headers to sign. + + is null. + -or- + is null. + + + does not contain the 'From' header. + -or- + contains one or more of the following headers: Return-Path, + Received, Comments, Keywords, Bcc, Resent-Bcc, or DKIM-Signature. + + + + + A base class for DKIM and ARC signers. + + + The base class for and . + + + + + Initialize a new instance of the class. + + + Creates a new . + Due to the recognized weakness of the SHA-1 hash algorithm + and the wide availability of the SHA-256 hash algorithm (it has been a required + part of DKIM since it was originally standardized in 2007), it is recommended + that NOT be used. + + The domain that the signer represents. + The selector subdividing the domain. + The signature algorithm. + + is null. + -or- + is null. + + + + + Get the domain that the signer represents. + + + Gets the domain that the signer represents. + + + + + The domain. + + + + Get the selector subdividing the domain. + + + Gets the selector subdividing the domain. + + + + + The selector. + + + + Get or set the algorithm to use for signing. + + + Gets or sets the algorithm to use for signing. + Creates a new . + Due to the recognized weakness of the SHA-1 hash algorithm + and the wide availability of the SHA-256 hash algorithm (it has been a required + part of DKIM since it was originally standardized in 2007), it is recommended + that NOT be used. + + + + + The signature algorithm. + + + + Get or set the canonicalization algorithm to use for the message body. + + + Gets or sets the canonicalization algorithm to use for the message body. + + + + + The canonicalization algorithm. + + + + Get or set the timespan after which signatures are no longer valid. + + + Get or set the timespan after which signatures are no longer valid. + + The signatures expiration timespan value. + + + + Get or set the canonicalization algorithm to use for the message headers. + + + Gets or sets the canonicalization algorithm to use for the message headers. + + + + + The canonicalization algorithm. + + + + Gets the private key. + + + The private key used for signing. + + The private key. + + + + Create the digest signing context. + + + Creates a new digest signing context. + + The digest signer. + + The is not supported. + + + + + A filter for the DKIM simple body canonicalization. + + + A filter for the DKIM simple body canonicalization. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Resets the filter. + + + Resets the filter. + + + + + A DKIM-Signature verifier. + + + Verifies DomainKeys Identified Mail (DKIM) signatures. + + + + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + The public key locator. + + is null. + + + + + Verify the specified DKIM-Signature header. + + + Verifies the specified DKIM-Signature header. + + + + + true if the DKIM-Signature is valid; otherwise, false. + The formatting options. + The message to verify. + The DKIM-Signature header. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + is not a DKIM-Signature header. + + + The DKIM-Signature header value is malformed. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously verify the specified DKIM-Signature header. + + + Verifies the specified DKIM-Signature header. + + + + + true if the DKIM-Signature is valid; otherwise, false. + The formatting options. + The message to verify. + The DKIM-Signature header. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + is not a DKIM-Signature header. + + + The DKIM-Signature header value is malformed. + + + The operation was canceled via the cancellation token. + + + + + Verify the specified DKIM-Signature header. + + + Verifies the specified DKIM-Signature header. + + + + + true if the DKIM-Signature is valid; otherwise, false. + The message to verify. + The DKIM-Signature header. + The cancellation token. + + is null. + -or- + is null. + + + is not a DKIM-Signature header. + + + The DKIM-Signature header value is malformed. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously verify the specified DKIM-Signature header. + + + Verifies the specified DKIM-Signature header. + + + + + true if the DKIM-Signature is valid; otherwise, false. + The message to verify. + The DKIM-Signature header. + The cancellation token. + + is null. + -or- + is null. + + + is not a DKIM-Signature header. + + + The DKIM-Signature header value is malformed. + + + The operation was canceled via the cancellation token. + + + + + A base class for DKIM and ARC verifiers. + + + The base class for and . + + + + + Initialize a new instance of the class. + + + Initializes the . + + The public key locator. + + is null. + + + + + Get the public key locator. + + + Gets the public key locator. + + The public key locator. + + + + Get or set the minimum allowed RSA key length. + + + Gets the minimum allowed RSA key length. + The DKIM specifications specify a single signing algorithm, RSA, + and recommend key sizes of 1024 to 2048 bits (but require verification of 512-bit keys). + As discussed in US-CERT Vulnerability Note VU#268267, the operational community has + recognized that shorter keys compromise the effectiveness of DKIM. While 1024-bit + signatures are common, stronger signatures are not. Widely used DNS configuration + software places a practical limit on key sizes, because the software only handles a + single 256-octet string in a TXT record, and RSA keys significantly longer than 1024 + bits don't fit in 256 octets. + + The minimum allowed RSA key length. + + + + Enable a DKIM signature algorithm. + + + Enables the specified DKIM signature algorithm. + Due to the recognized weakness of the SHA-1 hash algorithm + and the wide availability of the SHA-256 hash algorithm (it has been a required + part of DKIM since it was originally standardized in 2007), it is recommended + that NOT be enabled. + + The DKIM signature algorithm. + + + + Disable a DKIM signature algorithm. + + + Disables the specified DKIM signature algorithm. + Due to the recognized weakness of the SHA-1 hash algorithm + and the wide availability of the SHA-256 hash algorithm (it has been a required + part of DKIM since it was originally standardized in 2007), it is recommended + that NOT be enabled. + + The DKIM signature algorithm. + + + + Check whether a DKIM signature algorithm is enabled. + + + Determines whether the specified DKIM signature algorithm is enabled. + Due to the recognized weakness of the SHA-1 hash algorithm + and the wide availability of the SHA-256 hash algorithm (it has been a required + part of DKIM since it was originally standardized in 2007), it is recommended + that NOT be enabled. + + true if the specified DKIM signature algorithm is enabled; otherwise, false. + The DKIM signature algorithm. + + + + Create the digest signing context. + + + Creates a new digest signing context that uses the specified algorithm. + + The DKIM signature algorithm. + The public key. + The digest signer. + + + + Verify the hash of the message body. + + + Verifies the hash of the message body. + + The formatting options. + The signed MIME message. + The algorithm used to sign the message. + The algorithm used to canonicalize the message body. + The max length of the message body to hash or -1 to hash the entire message body. + The expected message body hash encoded in base64. + true if the calculated body hash matches ; otherwise, false. + + + + Verify the signature of the message headers. + + + Verifies the signature of the message headers. + + The formatting options. + The signed MIME message. + The DKIM-Signature or ARC-Message-Signature header. + The algorithm used to sign the message headers. + The public key used to verify the signature. + The list of headers that were signed. + The algorithm used to canonicalize the headers. + The expected signature of the headers encoded in base64. + true if the calculated signature matches ; otherwise, false. + + + + Encryption algorithms supported by S/MIME and OpenPGP. + + + Represents the available encryption algorithms for use with S/MIME and OpenPGP. + RC-2/40 was required by all S/MIME v2 implementations. However, since the + mid-to-late 1990's, RC-2/40 has been considered to be extremely weak and starting with + S/MIME v3.0 (published in 1999), all S/MIME implementations are required to implement + support for Triple-DES (aka 3DES) and should no longer encrypt using RC-2/40 unless + explicitly requested to do so by the user. + These days, most S/MIME implementations support the AES-128 and AES-256 + algorithms which are the recommended algorithms specified in S/MIME v3.2 and + should be preferred over the use of Triple-DES unless the client capabilities + of one or more of the recipients is unknown (or only supports Triple-DES). + + + + + The AES 128-bit encryption algorithm. + + + + + The AES 192-bit encryption algorithm. + + + + + The AES 256-bit encryption algorithm. + + + + + The Camellia 128-bit encryption algorithm. + + + + + The Camellia 192-bit encryption algorithm. + + + + + The Camellia 256-bit encryption algorithm. + + + + + The Cast-5 128-bit encryption algorithm. + + + + + The DES 56-bit encryption algorithm. + + + This is extremely weak encryption and should not be used + without consent from the user. + + + + + The Triple-DES encryption algorithm. + + + This is the weakest recommended encryption algorithm for use + starting with S/MIME v3 and should only be used as a fallback + if it is unknown what encryption algorithms are supported by + the recipient's mail client. + + + + + The IDEA 128-bit encryption algorithm. + + + + + The Blowfish encryption algorithm. + + + + + The Twofish encryption algorithm. + + + + + The RC2 40-bit encryption algorithm (S/MIME only). + + + This is extremely weak encryption and should not be used + without consent from the user. + + + + + The RC2 64-bit encryption algorithm (S/MIME only). + + + This is very weak encryption and should not be used + without consent from the user. + + + + + The RC2 128-bit encryption algorithm (S/MIME only). + + + + + The SEED 128-bit encryption algorithm (S/MIME only). + + + + + An that uses the GnuPG keyrings. + + + An that uses the GnuPG keyrings. + + + + + Initialize a new instance of the class. + + + Creates a new using the default path for the GnuPG home directory. + + + + + Initialize a new instance of the class. + + + Creates a new using the specified path for the GnuPG home directory. + + The path to the GnuPG home directory. + + is null. + + + + + Get the public keyring path. + + + Gets the public keyring path. + + The public key ring path. + + + + Get the secret keyring path. + + + Gets the secret keyring path. + + The secret key ring path. + + + + Get the public keyring bundle. + + + Gets the public keyring bundle. + + The public keyring bundle. + + + + Get the secret keyring bundle. + + + Gets the secret keyring bundle. + + The secret keyring bundle. + + + + Get the public keyring that contains the specified key. + + + Gets the public keyring that contains the specified key. + Implementations should first try to obtain the keyring stored (or cached) locally. + Failing that, if is enabled, they should use + to attempt to + retrieve the keyring from the configured . + + The public key identifier. + The cancellation token. + The public keyring that contains the specified key or null if the keyring could not be found. + + The operation was cancelled. + + + + + Asynchronously get the public keyring that contains the specified key. + + + Gets the public keyring that contains the specified key. + Implementations should first try to obtain the keyring stored (or cached) locally. + Failing that, if is enabled, they should use + to attempt to + retrieve the keyring from the configured . + + The public key identifier. + The cancellation token. + The public keyring that contains the specified key or null if the keyring could not be found. + + The operation was cancelled. + + + + + Enumerate all public keyrings. + + + Enumerates all public keyrings. + + The list of available public keyrings. + + + + Enumerate all public keys. + + + Enumerates all public keys. + + The list of available public keys. + + + + Enumerate the public keyrings for a particular mailbox. + + + Enumerates all public keyrings for the specified mailbox. + + The public keys. + Mailbox. + + is null. + + + + + Enumerate the public keys for a particular mailbox. + + + Enumerates all public keys for the specified mailbox. + + The public keys. + The mailbox address. + + is null. + + + + + Enumerate all secret keyrings. + + + Enumerates all secret keyrings. + + The list of available secret keyrings. + + + + Enumerate all secret keys. + + + Enumerates all secret keys. + + The list of available secret keys. + + + + Enumerate the secret keyrings for a particular mailbox. + + + Enumerates all secret keyrings for the specified mailbox. + + The secret keys. + The mailbox address. + + is null. + + + + + Enumerate the secret keys for a particular mailbox. + + + Enumerates all secret keys for the specified mailbox. + + The public keys. + The mailbox address. + + is null. + + + + + Get the public key associated with the mailbox address. + + + Gets a valid public key associated with the mailbox address that can be used for encryption. + + The public encryption key. + The mailbox. + + is null. + + + The public key for the specified could not be found. + + + + + Get the public keys for the specified mailbox addresses. + + + Gets a list of valid public keys for the specified mailbox addresses that can be used for encryption. + + The encryption keys. + The mailboxes. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + A public key for one or more of the could not be found. + + + + + Get the secret key for a specified key identifier. + + + Gets the secret key for a specified key identifier. + + The secret key. + The key identifier for the desired secret key. + The cancellation token. + + The operation was canceled via the cancellation token. + + + The secret key specified by the could not be found. + + + + + Get the signing key associated with the mailbox address. + + + Gets the signing key associated with the mailbox address. + + The signing key. + The mailbox. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + A secret key for the specified could not be found. + + + + + Check whether or not a particular mailbox address can be used for signing. + + + Checks whether or not as particular mailbocx address can be used for signing. + + true if the mailbox address can be used for signing; otherwise, false. + The signer. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Check whether or not the cryptography context can encrypt to a particular recipient. + + + Checks whether or not the cryptography context can be used to encrypt to a particular recipient. + + true if the cryptography context can be used to encrypt to the designated recipient; otherwise, false. + The recipient's mailbox address. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Generate a new key pair. + + + Generates a new RSA key pair. + + The mailbox to generate the key pair for. + The password to be set on the secret key. + The expiration date for the generated key pair. + The symmetric key algorithm to use. + The source of randomness to use when generating the key pair. + + is null. + -or- + is null. + + + is not a date in the future. + + + + + Sign a public key. + + + Signs a public key using the specified secret key. + Most OpenPGP implementations use + to make their "key signatures". Some implementations are known to use the other + certification types, but few differentiate between them. + + The secret key to use for signing. + The public key to sign. + The digest algorithm. + The certification to give the signed key. + + is null. + -or- + is null. + + + + + Saves the public key-ring bundle. + + + Atomically saves the public key-ring bundle to the path specified by . + Called by if any public keys were successfully imported. + + + An error occured while saving the public key-ring bundle. + + + + + Saves the secret key-ring bundle. + + + Atomically saves the secret key-ring bundle to the path specified by . + Called by if any secret keys were successfully imported. + + + An error occured while saving the secret key-ring bundle. + + + + + Import a public pgp keyring. + + + Imports a public pgp keyring. + + The public key-ring to import. + The cancellation token. + + is null. + + + An error occured while saving the public key-ring. + + + The operation was canceled via the cancellation token. + + + + + Import the specified public keyring bundle. + + + Imports the specified public keyring bundle. + + The bundle of public keyrings to import. + The cancellation token. + + is null. + + + An error occured while saving the public key-ring. + + + The operation was canceled via the cancellation token. + + + + + Import a secret pgp keyring. + + + Imports a secret pgp keyring. + + The secret key-ring to import. + The cancellation token. + + is null. + + + An error occured while saving the secret key-ring. + + + The operation was canceled via the cancellation token. + + + + + Import a secret pgp keyring bundle. + + + Imports a secret pgp keyring bundle. + + The bundle of secret keyrings to import. + The cancellation token. + + is null. + + + An error occured while saving the secret key-ring bundle. + + + The operation was canceled via the cancellation token. + + + + + Export the public keys for the specified mailboxes. + + + Exports the public keys for the specified mailboxes. + + A new instance containing the exported public keys. + The mailboxes associated with the public keys to export. + The cancellation token. + + is null. + + + was empty. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously export the public keys for the specified mailboxes. + + + Asynchronously exports the public keys for the specified mailboxes. + + A new instance containing the exported public keys. + The mailboxes associated with the public keys to export. + The cancellation token. + + is null. + + + was empty. + + + The operation was canceled via the cancellation token. + + + + + Export the public keyrings for the specified mailboxes. + + + Exports the public keyrings for the specified mailboxes. + + The mailboxes. + The output stream. + true if the output should be armored; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + was empty. + + + An I/O error occurred. + + + Exporting keys is not supported by this cryptography context. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously export the public keyrings for the specified mailboxes. + + + Asynchronously exports the public keyrings for the specified mailboxes. + + An asynchronous task context. + The mailboxes. + The output stream. + true if the output should be armored; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + was empty. + + + An I/O error occurred. + + + Exporting keys is not supported by this cryptography context. + + + The operation was canceled via the cancellation token. + + + + + Delete a public pgp keyring. + + + Deletes a public pgp keyring. + + The pgp keyring. + + is null. + + + + + Delete a secret pgp keyring. + + + Deletes a secret pgp keyring. + + The pgp keyring. + + is null. + + + + + An interface for a MIME part with a Content-Type of application/pgp-encrypted. + + + An application/pgp-encrypted part will typically be the first child of + a part and contains only a Version + header. + + + + + An interface for a MIME part with a Content-Type of application/pgp-signature. + + + An application/pgp-signature part contains detatched pgp signature data + and is typically contained within a part. + To verify the signature, use the one of the + Verify + methods on the parent multipart/signed part. + + + + + An interface for an S/MIME part with a Content-Type of application/pkcs7-mime. + + + An application/pkcs7-mime is an S/MIME part and may contain encrypted, + signed or compressed data (or any combination of the above). + + + + + Gets the value of the "smime-type" parameter. + + + Gets the value of the "smime-type" parameter. + + The value of the "smime-type" parameter. + + + + Decompress the compressed-data. + + + Decompresses the compressed-data using the specified . + + The decompressed . + The S/MIME context to use for decompressing. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "compressed-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decompress the compressed-data. + + + Asynchronously decompresses the compressed-data using the specified . + + The decompressed . + The S/MIME context to use for decompressing. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "compressed-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decompress the compressed-data. + + + Decompresses the compressed-data using the default . + + The decompressed . + The cancellation token. + + The "smime-type" parameter on the Content-Type header is not "compressed-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decompress the compressed-data. + + + Asynchronously decompresses the compressed-data using the default . + + The decompressed . + The cancellation token. + + The "smime-type" parameter on the Content-Type header is not "compressed-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decrypt the enveloped-data. + + + Decrypts the enveloped-data using the specified . + + The decrypted . + The S/MIME context to use for decrypting. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "enveloped-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decrypt the enveloped-data. + + + Asynchronously decrypts the enveloped-data using the specified . + + The decrypted . + The S/MIME context to use for decrypting. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "enveloped-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decrypt the enveloped-data. + + + Decrypts the enveloped-data using the default . + + The decrypted . + The cancellation token. + + The "smime-type" parameter on the Content-Type header is not "certs-only". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decrypt the enveloped-data. + + + Asynchronously decrypts the enveloped-data using the default . + + The decrypted . + The cancellation token. + + The "smime-type" parameter on the Content-Type header is not "certs-only". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Import the certificates contained in the application/pkcs7-mime content. + + + Imports the certificates contained in the application/pkcs7-mime content. + + The S/MIME context to import certificates into. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "certs-only". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously import the certificates contained in the application/pkcs7-mime content. + + + Asynchronously imports the certificates contained in the application/pkcs7-mime content. + + An asynchronous task context. + The S/MIME context to import certificates into. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "certs-only". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Verify the signed-data and return the unencapsulated . + + + Verifies the signed-data and returns the unencapsulated . + + The list of digital signatures. + The S/MIME context to use for verifying the signature. + The unencapsulated entity. + The cancellation token. + + is null. + + + The "smime-type" parameter on the Content-Type header is not "signed-data". + + + The extracted content could not be parsed as a MIME entity. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Verifies the signed-data and returns the unencapsulated . + + + Verifies the signed-data using the default and returns the + unencapsulated . + + The list of digital signatures. + The unencapsulated entity. + The cancellation token. + + The "smime-type" parameter on the Content-Type header is not "signed-data". + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + An interface for an S/MIME part with a Content-Type of application/pkcs7-signature. + + + An application/pkcs7-signature part contains detatched pkcs7 signature data + and is typically contained within a part. + To verify the signature, use one of the + Verify + methods on the parent multipart/signed part. + + + + + An abstract cryptography context interface. + + + Generally speaking, applications should not use a + directly, but rather via higher level APIs such as , + and . + + + + + Get or set whether a should be prepared before signing. + + + Gets or sets whether a should be prepared before signing. + + true if a MimeEntity should be prepared before signing; otherwise, false. + + + + Get the signature protocol. + + + The signature protocol is used by + in order to determine what the protocol parameter of the Content-Type + header should be. + + The signature protocol. + + + + Get the encryption protocol. + + + The encryption protocol is used by + in order to determine what the protocol parameter of the Content-Type + header should be. + + The encryption protocol. + + + + Get the key exchange protocol. + + + The key exchange protocol is really only used for OpenPGP. + + The key exchange protocol. + + + + Check whether or not the specified protocol is supported by the . + + + Used in order to make sure that the protocol parameter value specified in either a multipart/signed + or multipart/encrypted part is supported by the supplied cryptography context. + + true if the protocol is supported; otherwise false + The protocol. + + is null. + + + + + Get the enabled digest algorithms in ranked order. + + + Gets the enabled digest algorithms in ranked order. + + The enabled encryption algorithms. + + + + Enable the digest algorithm. + + + Enables the digest algorithm. + + The digest algorithm. + + + + Disable the digest algorithm. + + + Disables the digest algorithm. + + The digest algorithm. + + + + Get the digest algorithm from the micalg parameter value in a multipart/signed part. + + + Maps the micalg parameter value string back to the appropriate . + + The digest algorithm. + The micalg parameter value. + + is null. + + + + + Get the string name of the digest algorithm for use with the micalg parameter of a multipart/signed part. + + + Maps the to the appropriate string identifier + as used by the micalg parameter value of a multipart/signed Content-Type + header. + + The micalg value. + The digest algorithm. + + is out of range. + + + + + Check whether the specified digest algorithm is enabled. + + + Determines whether the specified digest algorithm is enabled. + + true if the specified digest algorithm is enabled; otherwise, false. + The digest algorithm. + + + + Get the enabled encryption algorithms in ranked order. + + + Gets the enabled encryption algorithms in ranked order. + + The enabled encryption algorithms. + + + + Enable the encryption algorithm. + + + Enables the encryption algorithm. + + The encryption algorithm. + + + + Disable the encryption algorithm. + + + Disables the encryption algorithm. + + The encryption algorithm. + + + + Check whether the specified encryption algorithm is enabled. + + + Determines whether the specified encryption algorithm is enabled. + + true if the specified encryption algorithm is enabled; otherwise, false. + The encryption algorithm. + + + + Check whether or not the cryptography context can encrypt to a particular recipient. + + + Checks whether or not the cryptography context can be used to encrypt to a particular recipient. + + true if the cryptography context can be used to encrypt to the designated recipient; otherwise, false. + The recipient's mailbox address. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously check whether or not the cryptography context can encrypt to a particular recipient. + + + Checks whether or not the cryptography context can be used to encrypt to a particular recipient. + + true if the cryptography context can be used to encrypt to the designated recipient; otherwise, false. + The recipient's mailbox address. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Encrypt the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + + + Asynchronously encrypt the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + + + Decrypt the specified encryptedData. + + + Decrypts the specified encryptedData. + + The decrypted . + The encrypted data. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously decrypt the specified encryptedData. + + + Asynchronously decrypts the specified encryptedData. + + The decrypted . + The encrypted data. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Check whether or not a particular mailbox address can be used for signing. + + + Checks whether or not as particular mailbocx address can be used for signing. + + true if the mailbox address can be used for signing; otherwise, false. + The signer. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously check whether or not a particular mailbox address can be used for signing. + + + Checks whether or not as particular mailbocx address can be used for signing. + + true if the mailbox address can be used for signing; otherwise, false. + The signer. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Sign the content using the specified signer and digest algorithm. + + + Signs the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + + + Asynchronously sign the content using the specified signer and digest algorithm. + + + Asynchronously signs the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + + + Verify the specified content using the detached signatureData. + + + Verifies the specified content using the detached signatureData. + + A list of digital signatures. + The content. + The signature data. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously verify the specified content using the detached signatureData. + + + Verifies the specified content using the detached signatureData. + + A list of digital signatures. + The content. + The signature data. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Imports the public certificates or keys from the specified stream. + + + Imports the public certificates or keys from the specified stream. + + The raw certificate or key data. + The cancellation token. + + is null. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously imports the public certificates or keys from the specified stream. + + + Asynchronously imports the public certificates or keys from the specified stream. + + An asynchronous task context. + The raw certificate or key data. + The cancellation token. + + is null. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Exports the keys for the specified mailboxes. + + + Exports the keys for the specified mailboxes. + + A new instance containing the exported keys. + The mailboxes. + The cancellation token. + + is null. + + + was empty. + + + Exporting keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously exports the keys for the specified mailboxes. + + + Asynchronously exports the keys for the specified mailboxes. + + A new instance containing the exported keys. + The mailboxes. + The cancellation token. + + is null. + + + was empty. + + + Exporting keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + An interface for a digital certificate. + + + An interface for a digital certificate. + + + + + Gets the public key algorithm supported by the certificate. + + + Gets the public key algorithm supported by the certificate. + + The public key algorithm. + + + + Gets the date that the certificate was created. + + + Gets the date that the certificate was created. + + The creation date. + + + + Gets the expiration date of the certificate. + + + Gets the expiration date of the certificate. + + The expiration date. + + + + Gets the fingerprint of the certificate. + + + Gets the fingerprint of the certificate. + + The fingerprint. + + + + Gets the email address of the owner of the certificate. + + + Gets the email address of the owner of the certificate. + + The email address. + + + + Gets the name of the owner of the certificate. + + + Gets the name of the owner of the certificate. + + The name of the owner. + + + + An interface for a digital signature. + + + An interface for a digital signature. + + + + + Gets certificate used by the signer. + + + Gets certificate used by the signer. + + The signer's certificate. + + + + Gets the public key algorithm used for the signature. + + + Gets the public key algorithm used for the signature. + + The public key algorithm. + + + + Gets the digest algorithm used for the signature. + + + Gets the digest algorithm used for the signature. + + The digest algorithm. + + + + Gets the creation date of the digital signature. + + + Gets the creation date of the digital signature. + + The creation date. + + + + Verifies the digital signature. + + + Verifies the digital signature. + + true if the signature is valid; otherwise, false. + + An error verifying the signature has occurred. + + + + + Verifies the digital signature. + + + Verifies the digital signature. + + true if only the signature itself should be verified; otherwise, both the signature and the certificate chain are validated. + true if the signature is valid; otherwise, false. + + An error verifying the signature has occurred. + + + + + An interface for a service which locates and retrieves DKIM public keys (probably via DNS). + + + An interface for a service which locates and retrieves DKIM public keys (probably via DNS). + Since MimeKit itself does not implement DNS, it is up to the client to implement public key lookups + via DNS. + + + + + + + + + + + + + + Locate and retrieve the public key for the given domain and selector. + + + Locates and retrieves the public key for the given domain and selector. + + + + + + + + + + The public key. + A colon-separated list of query methods used to retrieve the public key. The default is "dns/txt". + The domain. + The selector. + The cancellation token. + + + + Asynchronously locate and retrieve the public key for the given domain and selector. + + + Locates and retrieves the public key for the given domain and selector. + + + + + + + + + + The public key. + A colon-separated list of query methods used to retrieve the public key. The default is "dns/txt". + The domain. + The selector. + The cancellation token. + + + + An interface for a multipart MIME part with a ContentType of multipart/encrypted containing an encrypted MIME part. + + + This mime-type is common when dealing with PGP/MIME but is not used for S/MIME. + + + + + Decrypts the part. + + + Decrypts the and extracts any digital signatures in cases + where the content was also signed. + + The decrypted entity. + The OpenPGP cryptography context to use for decrypting. + A list of digital signatures if the data was both signed and encrypted. + The cancellation token. + + is null. + + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + The provided does not support the protocol parameter. + + + The private key could not be found to decrypt the encrypted data. + + + The has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was cancelled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Decrypts the part. + + + Decrypts the part. + + The decrypted entity. + The OpenPGP cryptography context to use for decrypting. + The cancellation token. + + is null. + + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + The provided does not support the protocol parameter. + + + The private key could not be found to decrypt the encrypted data. + + + The has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was cancelled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Decrypts the part. + + + Decrypts the and extracts any digital signatures in cases + where the content was also signed. + + The decrypted entity. + A list of digital signatures if the data was both signed and encrypted. + The cancellation token. + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + A suitable for + decrypting could not be found. + + + The private key could not be found to decrypt the encrypted data. + + + The has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was cancelled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Decrypts the part. + + + Decrypts the part. + + The decrypted entity. + The cancellation token. + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + A suitable for + decrypting could not be found. + + + The private key could not be found to decrypt the encrypted data. + + + The has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was cancelled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + An interface for a signed multipart, as used by both S/MIME and PGP/MIME protocols. + + + The first child of a multipart/signed is the content while the second child + is the detached signature data. Any other children are not defined and could + be anything. + + + + + Verify the multipart/signed part. + + + Verifies the multipart/signed part using the supplied cryptography context. + + A signer info collection. + The cryptography context to use for verifying the signature. + The cancellation token. + + is null. + + + The multipart is malformed in some way. + + + does not support verifying the signature part. + + + The has been disposed. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Verify the multipart/signed part. + + + Verifies the multipart/signed part using the supplied cryptography context. + + A signer info collection. + The cryptography context to use for verifying the signature. + The cancellation token. + + is null. + + + The multipart is malformed in some way. + + + does not support verifying the signature part. + + + The has been disposed. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Verify the multipart/signed part. + + + Verifies the multipart/signed part using the default cryptography context. + + A signer info collection. + The cancellation token. + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + A cryptography context suitable for verifying the signature could not be found. + + + The has been disposed. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously verify the multipart/signed part. + + + Verifies the multipart/signed part using the default cryptography context. + + A signer info collection. + The cancellation token. + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + A cryptography context suitable for verifying the signature could not be found. + + + The has been disposed. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + An interface for a Secure MIME (S/MIME) cryptography context. + + + Generally speaking, applications should not use a + directly, but rather via higher level APIs such as + and . + + + + + Compress the specified stream. + + + Compresses the specified stream. + + A new instance + containing the compressed content. + The stream to compress. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously compress the specified stream. + + + Asynchronously compresses the specified stream. + + A new instance + containing the compressed content. + The stream to compress. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decompress the specified stream. + + + Decompresses the specified stream. + + The decompressed mime part. + The stream to decompress. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decompress the specified stream. + + + Asynchronously decompresses the specified stream. + + The decompressed mime part. + The stream to decompress. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decompress the specified stream to an output stream. + + + Decompresses the specified stream to an output stream. + + The stream to decompress. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decompress the specified stream to an output stream. + + + Asynchronously decompresses the specified stream to an output stream. + + An asynchronous task context. + The stream to decompress. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Encrypts the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted content. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously encrypts the specified content for the specified recipients. + + + Asynchronously encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted content. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Decrypts the specified encryptedData to an output stream. + + + Decrypts the specified encryptedData to an output stream. + + The encrypted data. + The stream to write the decrypted data to. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously decrypts the specified encryptedData to an output stream. + + + Asynchronously decrypts the specified encryptedData to an output stream. + + An asynchronous task context. + The encrypted data. + The stream to write the decrypted data to. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Sign and encapsulate the content using the specified signer. + + + Signs and encapsulates the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously sign and encapsulate the content using the specified signer. + + + Asynchronously signs and encapsulates the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Sign and encapsulate the content using the specified signer and digest algorithm. + + + Signs and encapsulates the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign and encapsulate the content using the specified signer and digest algorithm. + + + Asynchronously signs and encapsulates the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign the content using the specified signer. + + + Signs the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously sign the content using the specified signer. + + + Asynchronously signs the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Verify the digital signatures of the specified signed data and extract the original content. + + + Verifies the digital signatures of the specified signed data and extracts the original content. + + The list of digital signatures. + The signed data. + The extracted MIME entity. + The cancellation token. + + is null. + + + The extracted content could not be parsed as a MIME entity. + + + The operation was cancelled via the cancellation token. + + + + + Verify the digital signatures of the specified signed data and extract the original content. + + + Verifies the digital signatures of the specified signed data and extracts the original content. + + The extracted content stream. + The signed data. + The digital signatures. + The cancellation token. + + is null. + + + An error occurred in the cryptographic message syntax subsystem. + + + The operation was cancelled via the cancellation token. + + + + + Imports certificates and keys from a pkcs12-encoded stream. + + + Imports certificates and keys from a pkcs12-encoded stream. + + The raw certificate and key data. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously imports certificates and keys from a pkcs12-encoded stream. + + + Asynchronously imports certificates and keys from a pkcs12-encoded stream. + + An asynchronous task context. + The raw certificate and key data. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Imports certificates and keys from a pkcs12 file. + + + Imports certificates and keys from a pkcs12 file. + + The raw certificate and key data in pkcs12 format. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + -or- + does not contain a private key. + -or- + does not contain a certificate that could be used for signing. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + An I/O error occurred. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously imports certificates and keys from a pkcs12 file. + + + Asynchronously imports certificates and keys from a pkcs12 file. + + An asynchronous task context. + The raw certificate and key data in pkcs12 format. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + -or- + does not contain a private key. + -or- + does not contain a certificate that could be used for signing. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + An I/O error occurred. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Import a certificate. + + + Imports a certificate. + + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously import a certificate. + + + Asynchronously imports a certificate. + + An asynchronous task context. + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + An interface for an X.509 Certificate database. + + + An X.509 certificate database is used for storing certificates, metdata related to the certificates + (such as encryption algorithms supported by the associated client), certificate revocation lists (CRLs), + and private keys. + + + + + Find the specified certificate. + + + Searches the database for the specified certificate, returning the matching + record with the desired fields populated. + + The matching record if found; otherwise null. + The certificate. + The desired fields. + + + + Finds the certificates matching the specified selector. + + + Searches the database for certificates matching the selector, returning all + matching certificates. + + The matching certificates. + The match selector or null to return all certificates. + + + + Finds the private keys matching the specified selector. + + + Searches the database for certificate records matching the selector, returning the + private keys for each matching record. + + The matching certificates. + The match selector or null to return all private keys. + + + + Finds the certificate records for the specified mailbox. + + + Searches the database for certificates matching the specified mailbox that are valid + for the date and time specified, returning all matching records populated with the + desired fields. + + The matching certificate records populated with the desired fields. + The mailbox. + The date and time. + true if a private key is required. + The desired fields. + + + + Finds the certificate records matching the specified selector. + + + Searches the database for certificate records matching the selector, returning all + of the matching records populated with the desired fields. + + The matching certificate records populated with the desired fields. + The match selector or null to match all certificates. + true if only trusted anchor certificates should be returned. + The desired fields. + + + + Add the specified certificate record. + + + Adds the specified certificate record to the database. + + The certificate record. + + + + Remove the specified certificate record. + + + Removes the specified certificate record from the database. + + The certificate record. + + + + Update the specified certificate record. + + + Updates the specified fields of the record in the database. + + The certificate record. + The fields to update. + + + + Finds the CRL records for the specified issuer. + + + Searches the database for CRL records matching the specified issuer, returning + all matching records populated with the desired fields. + + The matching CRL records populated with the desired fields. + The issuer. + The desired fields. + + + + Finds the specified certificate revocation list. + + + Searches the database for the specified CRL, returning the matching record with + the desired fields populated. + + The matching record if found; otherwise null. + The certificate revocation list. + The desired fields. + + + + Add the specified CRL record. + + + Adds the specified CRL record to the database. + + The CRL record. + + + + Remove the specified CRL record. + + + Removes the specified CRL record from the database. + + The CRL record. + + + + Update the specified CRL record. + + + Updates the specified fields of the record in the database. + + The CRL record. + + + + Gets a certificate revocation list store. + + + Gets a certificate revocation list store. + + A certificate recovation list store. + + + + A multipart MIME part with a ContentType of multipart/encrypted containing an encrypted MIME part. + + + This mime-type is common when dealing with PGP/MIME but is not used for S/MIME. + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The OpenPGP cryptography context to use for singing and encrypting. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + The is not supported. + -or- + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The OpenPGP cryptography context to use for singing and encrypting. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + The is not supported. + -or- + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The OpenPGP cryptography context to use for signing and encrypting. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + The private key for could not be found. + + + A public key for one or more of the could not be found. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The OpenPGP cryptography context to use for signing and encrypting. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + The private key for could not be found. + + + A public key for one or more of the could not be found. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + A default has not been registered. + -or- + The is not supported. + -or- + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + A default has not been registered. + -or- + The is not supported. + -or- + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + A default has not been registered. + + + The private key for could not be found. + + + A public key for one or more of the could not be found. + + + has been disposed. + + + The user chose to cancel the password prompt. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + A default has not been registered. + + + The private key for could not be found. + + + A public key for one or more of the could not be found. + + + has been disposed. + + + The user chose to cancel the password prompt. + + + 3 bad attempts were made to unlock the secret key. + + + + + Create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The OpenPGP cryptography context to use for singing and encrypting. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + The is not supported. + -or- + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The OpenPGP cryptography context to use for singing and encrypting. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + The is not supported. + -or- + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The OpenPGP cryptography context to use for singing and encrypting. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The OpenPGP cryptography context to use for singing and encrypting. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + A default has not been registered. + -or- + The is not supported. + -or- + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + A default has not been registered. + -or- + The is not supported. + -or- + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + A default has not been registered. + -or- + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously create a multipart/encrypted MIME part by signing and encrypting the specified entity. + + + Signs the entity using the supplied signer and digest algorithm and then encrypts to + the specified recipients, encapsulating the result in a new multipart/encrypted part. + + A new instance containing + the signed and encrypted version of the specified entity. + The signer to use to sign the entity. + The digest algorithm to use for signing. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The was out of range. + + + A default has not been registered. + -or- + The is not supported. + + + has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The OpenPGP cryptography context to use for encrypting. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + The specified encryption algorithm is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The OpenPGP cryptography context to use for encrypting. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + The specified encryption algorithm is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The OpenPGP cryptography context to use for encrypting. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A public key for one or more of the could not be found. + + + + + Asynchronously create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The OpenPGP cryptography context to use for encrypting. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A public key for one or more of the could not be found. + + + + + Create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + A default has not been registered. + -or- + The specified encryption algorithm is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + A default has not been registered. + -or- + The specified encryption algorithm is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + + + A default has not been registered. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A public key for one or more of the could not be found. + + + + + Asynchronously create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + + + A default has not been registered. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A public key for one or more of the could not be found. + + + + + Create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The OpenPGP cryptography context to use for encrypting. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + The specified encryption algorithm is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The OpenPGP cryptography context to use for encrypting. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + The specified encryption algorithm is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The OpenPGP cryptography context to use for encrypting. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The OpenPGP cryptography context to use for encrypting. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + A default has not been registered. + -or- + The specified encryption algorithm is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The encryption algorithm. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + A default has not been registered. + -or- + The specified encryption algorithm is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + A default has not been registered. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously create a multipart/encrypted MIME part by encrypting the specified entity. + + + Encrypts the entity to the specified recipients, encapsulating the result in a + new multipart/encrypted part. + + A new instance containing + the encrypted version of the specified entity. + The recipients for the encrypted entity. + The entity to sign and encrypt. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + + + A default has not been registered. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + + + Decrypts the part. + + + Decrypts the and extracts any digital signatures in cases + where the content was also signed. + + The decrypted entity. + The OpenPGP cryptography context to use for decrypting. + A list of digital signatures if the data was both signed and encrypted. + The cancellation token. + + is null. + + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + The provided does not support the protocol parameter. + + + The private key could not be found to decrypt the encrypted data. + + + The has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was cancelled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Decrypts the part. + + + Decrypts the part. + + The decrypted entity. + The OpenPGP cryptography context to use for decrypting. + The cancellation token. + + is null. + + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + The provided does not support the protocol parameter. + + + The private key could not be found to decrypt the encrypted data. + + + The has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was cancelled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Decrypts the part. + + + Decrypts the and extracts any digital signatures in cases + where the content was also signed. + + The decrypted entity. + A list of digital signatures if the data was both signed and encrypted. + The cancellation token. + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + A suitable for + decrypting could not be found. + + + The private key could not be found to decrypt the encrypted data. + + + The has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was cancelled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Decrypts the part. + + + Decrypts the part. + + The decrypted entity. + The cancellation token. + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + A suitable for + decrypting could not be found. + + + The private key could not be found to decrypt the encrypted data. + + + The has been disposed. + + + The user chose to cancel the password prompt. + -or- + The operation was cancelled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + A signed multipart, as used by both S/MIME and PGP/MIME protocols. + + + The first child of a multipart/signed is the content while the second child + is the detached signature data. Any other children are not defined and could + be anything. + + + + + Initialize a new instance of the class. + + This constructor is used by . + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Create a new . + + + Cryptographically signs the entity using the supplied signer and digest algorithm in + order to generate a detached signature and then adds the entity along with the + detached signature data to a new multipart/signed part. + + A new instance. + The cryptography context to use for signing. + The signer. + The digest algorithm to use for signing. + The entity to sign. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + The was out of range. + + + The is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + The private key could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously create a new . + + + Cryptographically signs the entity using the supplied signer and digest algorithm in + order to generate a detached signature and then adds the entity along with the + detached signature data to a new multipart/signed part. + + A new instance. + The cryptography context to use for signing. + The signer. + The digest algorithm to use for signing. + The entity to sign. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + The was out of range. + + + The is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + The private key could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Create a new . + + + Cryptographically signs the entity using the supplied signer and digest algorithm in + order to generate a detached signature and then adds the entity along with the + detached signature data to a new multipart/signed part. + + A new instance. + The OpenPGP context to use for signing. + The signer. + The digest algorithm to use for signing. + The entity to sign. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + + + The was out of range. + + + The is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the OpenPGP subsystem. + + + + + Asynchronously create a new . + + + Cryptographically signs the entity using the supplied signer and digest algorithm in + order to generate a detached signature and then adds the entity along with the + detached signature data to a new multipart/signed part. + + A new instance. + The OpenPGP context to use for signing. + The signer. + The digest algorithm to use for signing. + The entity to sign. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + + + The was out of range. + + + The is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the OpenPGP subsystem. + + + + + Create a new . + + + Cryptographically signs the entity using the supplied signer and digest algorithm in + order to generate a detached signature and then adds the entity along with the + detached signature data to a new multipart/signed part. + + A new instance. + The signer. + The digest algorithm to use for signing. + The entity to sign. + The cancellation token. + + is null. + -or- + is null. + + + cannot be used for signing. + + + The was out of range. + + + A cryptography context suitable for signing could not be found. + -or- + The is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the OpenPGP subsystem. + + + + + Asynchronously create a new . + + + Cryptographically signs the entity using the supplied signer and digest algorithm in + order to generate a detached signature and then adds the entity along with the + detached signature data to a new multipart/signed part. + + A new instance. + The signer. + The digest algorithm to use for signing. + The entity to sign. + The cancellation token. + + is null. + -or- + is null. + + + cannot be used for signing. + + + The was out of range. + + + A cryptography context suitable for signing could not be found. + -or- + The is not supported. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the OpenPGP subsystem. + + + + + Create a new . + + + Cryptographically signs the entity using the supplied signer in order + to generate a detached signature and then adds the entity along with + the detached signature data to a new multipart/signed part. + + A new instance. + The S/MIME context to use for signing. + The signer. + The entity to sign. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously create a new . + + + Cryptographically signs the entity using the supplied signer in order + to generate a detached signature and then adds the entity along with + the detached signature data to a new multipart/signed part. + + A new instance. + The S/MIME context to use for signing. + The signer. + The entity to sign. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Create a new . + + + Cryptographically signs the entity using the supplied signer in order + to generate a detached signature and then adds the entity along with + the detached signature data to a new multipart/signed part. + + A new instance. + The signer. + The entity to sign. + The cancellation token. + + is null. + -or- + is null. + + + A cryptography context suitable for signing could not be found. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously create a new . + + + Cryptographically signs the entity using the supplied signer in order + to generate a detached signature and then adds the entity along with + the detached signature data to a new multipart/signed part. + + A new instance. + The signer. + The entity to sign. + The cancellation token. + + is null. + -or- + is null. + + + A cryptography context suitable for signing could not be found. + + + has been disposed. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Prepare the MIME entity for transport using the specified encoding constraints. + + + Prepares the MIME entity for transport using the specified encoding constraints. + + The encoding constraint. + The maximum number of octets allowed per line (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + -or- + is not a valid value. + + + + + Verify the multipart/signed part. + + + Verifies the multipart/signed part using the supplied cryptography context. + + A signer info collection. + The cryptography context to use for verifying the signature. + The cancellation token. + + is null. + + + The multipart is malformed in some way. + + + does not support verifying the signature part. + + + The has been disposed. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Verify the multipart/signed part. + + + Verifies the multipart/signed part using the supplied cryptography context. + + A signer info collection. + The cryptography context to use for verifying the signature. + The cancellation token. + + is null. + + + The multipart is malformed in some way. + + + does not support verifying the signature part. + + + The has been disposed. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Verify the multipart/signed part. + + + Verifies the multipart/signed part using the default cryptography context. + + A signer info collection. + The cancellation token. + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + A cryptography context suitable for verifying the signature could not be found. + + + The has been disposed. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously verify the multipart/signed part. + + + Verifies the multipart/signed part using the default cryptography context. + + A signer info collection. + The cancellation token. + + The protocol parameter was not specified. + -or- + The multipart is malformed in some way. + + + A cryptography context suitable for verifying the signature could not be found. + + + The has been disposed. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + A filter to strip off data before and after an armored OpenPGP block. + + + Filters out data before and after armored OpenPGP blocks. + + + + + Initialize a new instance of the class. + + + Creates a new . + + An OpenPGP begin marker. + An OpenPGP end marker. + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Resets the filter. + + + Resets the filter. + + + + + An abstract OpenPGP cryptography context which can be used for PGP/MIME. + + + An abstract OpenPGP cryptography context which can be used for PGP/MIME. + Generally speaking, applications should not use an + directly, but rather via higher level APIs such as + and . + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Get the password for a secret key. + + + Gets the password for a secret key. + + The password for the secret key. + The secret key. + + The user chose to cancel the password request. + + + + + Get the public keyring that contains the specified key. + + + Gets the public keyring that contains the specified key. + Implementations should first try to obtain the keyring stored (or cached) locally. + Failing that, if is enabled, they should use + to attempt to + retrieve the keyring from the configured . + + The public key identifier. + The cancellation token. + The public keyring that contains the specified key or null if the keyring could not be found. + + The operation was canceled via the cancellation token. + + + + + Asynchronously get the public keyring that contains the specified key asynchronously. + + + Asynchronously gets the public keyring that contains the specified key. + Implementations should first try to obtain the keyring stored (or cached) locally. + Failing that, if is enabled, they should use + to attempt to + retrieve the keyring from the configured . + + The public key identifier. + The cancellation token. + The public keyring that contains the specified key or null if the keyring could not be found. + + The operation was canceled via the cancellation token. + + + + + Get the secret key for a specified key identifier. + + + Gets the secret key for a specified key identifier. + + The secret key. + The key identifier for the desired secret key. + The cancellation token. + + The operation was canceled via the cancellation token. + + + The secret key specified by the could not be found. + + + + + Asynchronously get the secret key for a specified key identifier. + + + Asynchronously gets the secret key for a specified key identifier. + + The secret key. + The key identifier for the desired secret key. + The cancellation token. + + The operation was canceled via the cancellation token. + + + The secret key specified by the could not be found. + + + + + Get the public keys for the specified mailbox addresses. + + + Gets a list of valid public keys for the specified mailbox addresses that can be used for encryption. + + The encryption keys. + The mailboxes. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + A public key for one or more of the could not be found. + + + + + Asynchronously get the public keys for the specified mailbox addresses. + + + Asynchronously gets a list of valid public keys for the specified mailbox addresses that can be used for encryption. + + The encryption keys. + The mailboxes. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + A public key for one or more of the could not be found. + + + + + Get the signing key associated with the mailbox address. + + + Gets the signing key associated with the mailbox address. + + The signing key. + The mailbox. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + A secret key for the specified could not be found. + + + + + Asynchronously get the signing key associated with the mailbox address. + + + Asynchronously gets the signing key associated with the mailbox address. + + The signing key. + The mailbox. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + A secret key for the specified could not be found. + + + + + Get or set the default encryption algorithm. + + + Gets or sets the default encryption algorithm. + + The encryption algorithm. + + The specified encryption algorithm is not supported. + + + + + Get or set the key server to use when automatically retrieving keys. + + + Gets or sets the key server to use when verifying keys that are + not already in the public keychain. + Only HTTP and HKP protocols are supported. + + The key server. + + is not an absolute URI. + + + + + Get or set whether unknown PGP keys should automtically be retrieved. + + + Gets or sets whether or not the should automatically + fetch keys as needed from the keyserver when verifying signatures. + Requires a valid to be set. + + true if unknown PGP keys should automatically be retrieved; otherwise, false. + + + + Get the signature protocol. + + + The signature protocol is used by + in order to determine what the protocol parameter of the Content-Type + header should be. + + The signature protocol. + + + + Get the encryption protocol. + + + The encryption protocol is used by + in order to determine what the protocol parameter of the Content-Type + header should be. + + The encryption protocol. + + + + Get the key exchange protocol. + + + Gets the key exchange protocol. + + The key exchange protocol. + + + + Check whether or not the specified protocol is supported. + + + Used in order to make sure that the protocol parameter value specified in either a multipart/signed + or multipart/encrypted part is supported by the supplied cryptography context. + + true if the protocol is supported; otherwise false + The protocol. + + is null. + + + + + Get the string name of the digest algorithm for use with the micalg parameter of a multipart/signed part. + + + Maps the to the appropriate string identifier + as used by the micalg parameter value of a multipart/signed Content-Type + header. For example: + + AlgorithmName + pgp-md5 + pgp-sha1 + pgp-ripemd160 + pgp-md2 + pgp-tiger192 + pgp-haval-5-160 + pgp-sha256 + pgp-sha384 + pgp-sha512 + pgp-sha224 + + + The micalg value. + The digest algorithm. + + is out of range. + + + + + Get the digest algorithm from the micalg parameter value in a multipart/signed part. + + + Maps the micalg parameter value string back to the appropriate . + + The digest algorithm. + The micalg parameter value. + + is null. + + + + + Hex encode an array of bytes. + + + This method is used to hex-encode the PGP key fingerprints. + + The data to encode. + A string representing the hex-encoded data. + + + + Check that a public key is a match for the specified mailbox. + + + Checks that the public key is a match for the specified mailbox. + If the is a with a non-empty + , then the fingerprint is used to match the key's + fingerprint. Otherwise, the email address(es) contained within the key's user identifier strings + are compared to the mailbox address. + + The public key. + The mailbox address. + true if the key is a match for the specified mailbox; otherwise, false. + + is null. + -or- + is null. + + + + + Check that a secret key is a match for the specified mailbox. + + + Checks that the secret key is a match for the specified mailbox. + If the is a with a non-empty + , then the fingerprint is used to match the key's + fingerprint. Otherwise, the email address(es) contained within the key's user identifier strings + are compared to the mailbox address. + + The secret key. + The mailbox address. + true if the key is a match for the specified mailbox; otherwise, false. + + is null. + -or- + is null. + + + + + Check if a public key is expired. + + + Checks if a public key is expired. + + The public key. + true if the public key is expired; otherwise, false. + + is null. + + + + + Retrieves the public keyring, using the preferred key server, automatically importing it afterwards. + + The identifier of the key to be retrieved. + true if this operation should be done asynchronously; otherwise, false. + The cancellation token. + The public key ring. + + + + Retrieve the public keyring using the configured key server. + + + Retrieves the public keyring specified by the from the key server + set on the property. If the keyring is successfully retrieved, it will + be imported via . + This method should be called by + when the keyring is not available locally. + + The identifier of the public key to be retrieved. + The cancellation token. + The public key ring. + + + + Asynchronously retrieve the public keyring using the configured key server. + + + Retrieves the public keyring specified by the from the key server + set on the property. If the keyring is successfully retrieved, it will + be imported via . + This method should be called by + when the keyring is not available locally. + + The identifier of the public key to be retrieved. + The cancellation token. + The public key ring. + + + + Gets the private key from the specified secret key. + + + Gets the private key from the specified secret key. + + The private key. + The secret key. + + is null. + + + The user chose to cancel the password prompt. + + + 3 bad attempts were made to unlock the secret key. + + + + + Gets the equivalent for the + specified . + + + Maps a to the equivalent . + + The hash algorithm. + The digest algorithm. + + is out of range. + + + is not a supported digest algorithm. + + + + + Sign the content using the specified signer and digest algorithm. + + + Signs the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + A signing key could not be found for . + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously sign the content using the specified signer and digest algorithm. + + + Asynchronously signs the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + A signing key could not be found for . + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Sign the content using the specified signer and digest algorithm. + + + Signs the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + cannot be used for signing. + + + The was out of range. + + + The is not supported. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously sign the content using the specified signer and digest algorithm. + + + Asynchronously signs the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + cannot be used for signing. + + + The was out of range. + + + The is not supported. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Gets the equivalent for the specified + . + + + Gets the equivalent for the specified + . + + The digest algorithm. + The hash algorithm. + + is out of range. + + + does not have an equivalent value. + + + + + Gets the equivalent for the specified + . + + + Gets the equivalent for the specified + . + + The public-key algorithm. + The public-key algorithm. + + is out of range. + + + does not have an equivalent value. + + + + + Verify the specified content using the detached signatureData. + + + Verifies the specified content using the detached signatureData. + If any of the signatures were made with an unrecognized key and is enabled, + an attempt will be made to retrieve said key(s). The can be used to cancel + key retrieval. + + A list of digital signatures. + The content. + The signature data. + The cancellation token. + + is null. + -or- + is null. + + + does not contain valid PGP signature data. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously verify the specified content using the detached signatureData. + + + Verifies the specified content using the detached signatureData. + If any of the signatures were made with an unrecognized key and is enabled, + an attempt will be made to retrieve said key(s). The can be used to cancel + key retrieval. + + A list of digital signatures. + The content. + The signature data. + The cancellation token. + + is null. + -or- + is null. + + + does not contain valid PGP signature data. + + + The operation was canceled via the cancellation token. + + + + + Encrypt the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The operation was canceled via the cancellation token. + + + A public key could not be found for one or more of the . + + + + + Asynchronously encrypt the specified content for the specified recipients. + + + Asynchronously encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The operation was canceled via the cancellation token. + + + A public key could not be found for one or more of the . + + + + + Encrypt the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The encryption algorithm. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + A public key could not be found for one or more of the . + + + The specified encryption algorithm is not supported. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously encrypt the specified content for the specified recipients. + + + Asynchronously encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The encryption algorithm. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + A public key could not be found for one or more of the . + + + The specified encryption algorithm is not supported. + + + The operation was canceled via the cancellation token. + + + + + Encrypt the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The encryption algorithm. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The specified encryption algorithm is not supported. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously encrypt the specified content for the specified recipients. + + + Asynchronously encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The encryption algorithm. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The specified encryption algorithm is not supported. + + + The operation was canceled via the cancellation token. + + + + + Encrypt the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously encrypt the specified content for the specified recipients. + + + Asynchronously encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The operation was canceled via the cancellation token. + + + + + Sign and encrypt the specified content for the specified recipients. + + + Signs and encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The signer. + The digest algorithm to use for signing. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + is out of range. + + + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The specified is not supported by this context. + + + The private key could not be found for . + + + A public key could not be found for one or more of the . + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously sign and encrypt the specified content for the specified recipients. + + + Asynchronously signs and encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The signer. + The digest algorithm to use for signing. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + is out of range. + + + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The specified is not supported by this context. + + + The private key could not be found for . + + + A public key could not be found for one or more of the . + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Sign and encrypt the specified content for the specified recipients. + + + Signs and encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The signer. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The specified encryption algorithm is not supported. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously sign and encrypt the specified content for the specified recipients. + + + Asynchronously signs and encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The signer. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The specified encryption algorithm is not supported. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Sign and encrypt the specified content for the specified recipients. + + + Signs and encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The signer. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The specified encryption algorithm is not supported. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously sign and encrypt the specified content for the specified recipients. + + + Asynchronously signs and encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The signer. + The digest algorithm to use for signing. + The encryption algorithm. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The specified encryption algorithm is not supported. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Sign and encrypt the specified content for the specified recipients. + + + Signs and encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The signer. + The digest algorithm to use for signing. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Asynchronously sign and encrypt the specified content for the specified recipients. + + + Asynchronously signs and encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The signer. + The digest algorithm to use for signing. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + cannot be used for signing. + -or- + One or more of the recipient keys cannot be used for encrypting. + -or- + No recipients were specified. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + + + Decrypt an encrypted stream and extract the digital signers if the content was also signed. + + + Decrypts an encrypted stream and extracts the digital signers if the content was also signed. + If any of the signatures were made with an unrecognized key and is enabled, + an attempt will be made to retrieve said key(s). The can be used to cancel + key retrieval. + + The list of digital signatures if the data was both signed and encrypted; otherwise, null. + The encrypted data. + The stream to write the decrypted data to. + The cancellation token. + + is null. + -or- + is null. + + + The private key could not be found to decrypt the stream. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + An OpenPGP error occurred. + + + + + Asynchronously decrypt an encrypted stream and extract the digital signers if the content was also signed. + + + Decrypts an encrypted stream and extracts the digital signers if the content was also signed. + If any of the signatures were made with an unrecognized key and is enabled, + an attempt will be made to retrieve said key(s). The can be used to cancel + key retrieval. + + The list of digital signatures if the data was both signed and encrypted; otherwise, null. + The encrypted data. + The stream to write the decrypted data to. + The cancellation token. + + is null. + -or- + is null. + + + The private key could not be found to decrypt the stream. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + An OpenPGP error occurred. + + + + + Decrypt the specified encryptedData and extracts the digital signers if the content was also signed. + + + Decrypts the specified encryptedData and extracts the digital signers if the content was also signed. + + The decrypted . + The encrypted data. + A list of digital signatures if the data was both signed and encrypted. + The cancellation token. + + is null. + + + The private key could not be found to decrypt the stream. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + An OpenPGP error occurred. + + + + + Decrypt the specified encryptedData. + + + Decrypts the specified encryptedData. + + The decrypted . + The encrypted data. + The cancellation token. + + is null. + + + The private key could not be found to decrypt the stream. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + An OpenPGP error occurred. + + + + + Asynchronously decrypt the specified encryptedData. + + + Asynchronously decrypts the specified encryptedData. + + The decrypted . + The encrypted data. + The cancellation token. + + is null. + + + The private key could not be found to decrypt the stream. + + + The user chose to cancel the password prompt. + -or- + The operation was canceled via the cancellation token. + + + 3 bad attempts were made to unlock the secret key. + + + An OpenPGP error occurred. + + + + + Import a public pgp keyring. + + + Imports a public pgp keyring. + + The public key-ring to import. + The cancellation token. + + is null. + + + An error occured while saving the public key-ring. + + + The operation was canceled via the cancellation token. + + + + + Import the specified public keyring bundle. + + + Imports the specified public keyring bundle. + + The bundle of public keyrings to import. + The cancellation token. + + is null. + + + An error occured while saving the public key-ring. + + + The operation was canceled via the cancellation token. + + + + + Import a secret pgp keyring. + + + Imports a secret pgp keyring. + + The secret key-ring to import. + The cancellation token. + + is null. + + + An error occured while saving the secret key-ring. + + + The operation was canceled via the cancellation token. + + + + + Import a secret pgp keyring bundle. + + + Imports a secret pgp keyring bundle. + + The bundle of secret keyrings to import. + The cancellation token. + + is null. + + + An error occured while saving the secret key-ring bundle. + + + The operation was canceled via the cancellation token. + + + + + Import public pgp keys from the specified stream. + + + Imports public pgp keys from the specified stream. + + The raw key data. + The cancellation token. + + is null. + + + An error occurred while parsing the raw key-ring data + -or- + An error occured while saving the public key-ring bundle. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously import public pgp keys from the specified stream. + + + Asynchronously imports public pgp keys from the specified stream. + + An asynchronous task context. + The raw key data. + The cancellation token. + + is null. + + + An error occurred while parsing the raw key-ring data + -or- + An error occured while saving the public key-ring bundle. + + + The operation was canceled via the cancellation token. + + + + + Export the specified public keys. + + + Exports the specified public keys. + + A new instance containing the exported public keys. + The public keys to export. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously export the specified public keys. + + + Asynchronously exports the specified public keys. + + A new instance containing the exported public keys. + The public keys to export. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Export the specified public keys. + + + Exports the specified public keys. + + A new instance containing the exported public keys. + The public keys to export. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously export the specified public keys. + + + Asynchronously exports the specified public keys. + + A new instance containing the exported public keys. + The public keys to export. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Export the specified public keys. + + + Exports the specified public keys. + + The public keys to export. + The output stream. + true if the output should be armored; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously export the specified public keys. + + + Asynchronously exports the specified public keys. + + An asynchronous task context. + The public keys to export. + The output stream. + true if the output should be armored; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Export the public keyring bundle. + + + Exports the public keyring bundle. + + The public keyring bundle to export. + The output stream. + true if the output should be armored; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously export the public keyring bundle. + + + Asynchronously exports the public keyring bundle. + + An asynchronous task context. + The public keyring bundle to export. + The output stream. + true if the output should be armored; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + An I/O error occurred. + + + The operation was canceled via the cancellation token. + + + + + Export the public keyrings for the specified mailboxes. + + + Exports the public keyrings for the specified mailboxes. + + The mailboxes. + The output stream. + true if the output should be armored; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + was empty. + + + An I/O error occurred. + + + Exporting keys is not supported by this cryptography context. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously export the public keyrings for the specified mailboxes. + + + Asynchronously exports the public keyrings for the specified mailboxes. + + An asynchronous task context. + The mailboxes. + The output stream. + true if the output should be armored; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + was empty. + + + An I/O error occurred. + + + Exporting keys is not supported by this cryptography context. + + + The operation was canceled via the cancellation token. + + + + + Releases all resources used by the object. + + Call when you are finished using the . The + method leaves the in an unusable state. After + calling , you must release all references to the so + the garbage collector can reclaim the memory that the was occupying. + + + + An enum expressing a type of OpenPGP data. + + + An enum expressing a type of OpenPGP data. + + + + + No OpenPGP data detected. + + + + + The OpenPGP data is a signed message. + + + + + The OpenPGP data is an encrypted message. + + + + + The OpenPGP data is a public key. + + + + + The OpenPGP data is a private key. + + + + + A filter meant to aid in the detection of OpenPGP blocks. + + + Detects OpenPGP block markers and their byte offsets. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Get the byte offset of the BEGIN marker, if available. + + + Gets the byte offset of the BEGIN marker if available. + + The byte offset. + + + + Get the byte offset of the END marker, if available. + + + Gets the byte offset of the END marker if available. + + The byte offset. + + + + Get the type of OpenPGP data detected. + + + Gets the type of OpenPGP data detected. + + The type of OpenPGP data detected. + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Resets the filter. + + + Resets the filter. + + + + + An OpenPGP digital certificate. + + + An OpenPGP digital certificate. + + + + + Gets the public key ring. + + + Get the public key ring that is associated with. + + The key ring. + + + + Gets the public key. + + + Get the public key. + + The public key. + + + + Gets the public key algorithm supported by the certificate. + + + Gets the public key algorithm supported by the certificate. + + The public key algorithm. + + + + Gets the date that the certificate was created. + + + Gets the date that the certificate was created. + + The creation date. + + + + Gets the expiration date of the certificate. + + + Gets the expiration date of the certificate. + + The expiration date. + + + + Gets the fingerprint of the certificate. + + + Gets the fingerprint of the certificate. + + The fingerprint. + + + + Gets the email address of the owner of the certificate. + + + Gets the email address of the owner of the certificate. + + The email address. + + + + Gets the name of the owner of the certificate. + + + Gets the name of the owner of the certificate. + + The name of the owner. + + + + An OpenPGP digital signature. + + + An OpenPGP digital signature. + + + + + Gets certificate used by the signer. + + + Gets certificate used by the signer. + + The signer's certificate. + + + + Gets the public key algorithm used for the signature. + + + Gets the public key algorithm used for the signature. + + The public key algorithm. + + + + Gets the digest algorithm used for the signature. + + + Gets the digest algorithm used for the signature. + + The digest algorithm. + + + + Gets the creation date of the digital signature. + + + Gets the creation date of the digital signature. + + The creation date. + + + + Verifies the digital signature. + + + Verifies the digital signature. + + true if the signature is valid; otherwise, false. + + An error verifying the signature has occurred. + + + + + Verifies the digital signature. + + + Verifies the digital signature. + + This option is ignored for OpenPGP digital signatures. + true if the signature is valid; otherwise, false. + + An error verifying the signature has occurred. + + + + + An OpenPGP key certification. + + + An OpenPGP key certification. + + + + + Generic certification of a User ID and Public-Key packet. + The issuer of this certification does not make any particular + assertion as to how well the certifier has checked that the owner + of the key is in fact the person described by the User ID. + + + + + Persona certification of a User ID and Public-Key packet. + The issuer of this certification has not done any verification of + the claim that the owner of this key is the User ID specified. + + + + + Casual certification of a User ID and Public-Key packet. + The issuer of this certification has done some casual + verification of the claim of identity. + + + + + Positive certification of a User ID and Public-Key packet. + The issuer of this certification has done substantial + verification of the claim of identity. + + + + + An exception that is thrown when a private key could not be found for a specified mailbox or key id. + + + An exception that is thrown when a private key could not be found for a specified mailbox or key id. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The serialization info. + The stream context. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The mailbox that could not be resolved to a valid private key. + A message explaining the error. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The key id that could not be resolved to a valid certificate. + A message explaining the error. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The key id that could not be resolved to a valid certificate. + A message explaining the error. + + is null. + + + + + When overridden in a derived class, sets the + with information about the exception. + + + Sets the + with information about the exception. + + The serialization info. + The streaming context. + + is null. + + + + + Gets the key id that could not be found. + + + Gets the key id that could not be found. + + The key id. + + + + An enumeration of public key algorithms. + + + An enumeration of public key algorithms. + + + + + No public key algorithm specified. + + + + + The RSA algorithm. + + + + + The RSA encryption-only algorithm. + + + + + The RSA sign-only algorithm. + + + + + The El-Gamal encryption-only algorithm. + + + + + The DSA algorithm. + + + + + The elliptic curve algorithm (aka EC or ECDH). + + + + + The elliptic curve DSA algorithm (aka ECDSA). + + + + + The El-Gamal algorithm. + + + + + The Diffie-Hellman algorithm. + + + + + The Edwards-Curve DSA algorithm (aka EdDSA). + + + + + An exception that is thrown when a public key could not be found for a specified mailbox. + + + An exception that is thrown when a public key could not be found for a specified mailbox. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The serialization info. + The stream context. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The mailbox that could not be resolved to a valid private key. + A message explaining the error. + + + + When overridden in a derived class, sets the + with information about the exception. + + + Sets the + with information about the exception. + + The serialization info. + The streaming context. + + is null. + + + + + Gets the key id that could not be found. + + + Gets the key id that could not be found. + + The key id. + + + + The RSA encryption padding schemes and parameters used by S/MIME. + + + The RSA encryption padding schemes and parameters used by S/MIME as described in + rfc8017. + + + + + The PKCS #1 v1.5 encryption padding. + + + The PKCS #1 v1.5 encryption padding. + + + + + The Optimal Asymmetric Encryption Padding (OAEP) scheme using the default (SHA-1) hash algorithm. + + + The Optimal Asymmetric Encryption Padding (OAEP) scheme using the default (SHA-1) hash algorithm. + + + + + The Optimal Asymmetric Encryption Padding (OAEP) scheme using the SHA-256 hash algorithm. + + + The Optimal Asymmetric Encryption Padding (OAEP) scheme using the SHA-256 hash algorithm. + + + + + The Optimal Asymmetric Encryption Padding (OAEP) scheme using the SHA-384 hash algorithm. + + + The Optimal Asymmetric Encryption Padding (OAEP) scheme using the SHA-384 hash algorithm. + + + + + The Optimal Asymmetric Encryption Padding (OAEP) scheme using the SHA-512 hash algorithm. + + + The Optimal Asymmetric Encryption Padding (OAEP) scheme using the SHA-512 hash algorithm. + + + + + Get the RSA encryption padding scheme. + + + Gets the RSA encryption padding scheme. + + The RSA encryption padding scheme. + + + + Get the hash algorithm used for RSAES-OAEP padding. + + + Gets the hash algorithm used for RSAES-OAEP padding. + + The hash algorithm used for RSAES-OAEP padding. + + + + Determines whether the specified is equal to the current . + + + Compares two RSA encryption paddings to determine if they are identical or not. + + The to compare with the current . + true if the specified is equal to the current + ; otherwise, false. + + + + Determines whether the specified object is equal to the current object. + + + The type of comparison between the current instance and the parameter depends on whether + the current instance is a reference type or a value type. + + The object to compare with the current object. + true if the specified object is equal to the current object; otherwise, false. + + + + Returns the hash code for this instance. + + + Returns the hash code for this instance. + + A hash code for the current object. + + + + Returns a that represents the current + . + + + Creates a string-representation of the . + + A that represents the current + . + + + + Compare two objects for equality. + + + Compares two objects for equality. + + The first object to compare. + The second object to compare. + true if and are equal; otherwise, false. + + + + Compare two objects for inequality. + + + Compares two objects for inequality. + + The first object to compare. + The second object to compare. + true if and are unequal; otherwise, false. + + + + Create a new using and the specified hash algorithm. + + + Creates a new using and the specified hash algorithm. + + The hash algorithm. + An using and the specified hash algorithm. + + The is not supported. + + + + + The RSA encryption padding schemes used by S/MIME. + + + The RSA encryption padding schemes used by S/MIME as described in + rfc8017. + + + + + The PKCS #1 v1.5 encryption padding scheme. + + + + + The Optimal Asymmetric Encryption Padding (OAEP) scheme. + + + + + The RSA signature padding schemes and parameters used by S/MIME. + + + The RSA signature padding schemes and parameters used by S/MIME as described in + rfc8017. + + + + + The PKCS #1 v1.5 signature padding. + + + The PKCS #1 v1.5 signature padding. + + + + + The Probibilistic Signature Scheme (PSS) padding. + + + The Probibilistic Signature Scheme (PSS) padding. + + + + + Get the RSA signature padding scheme. + + + Gets the RSA signature padding scheme. + + The RSA signature padding scheme. + + + + Determines whether the specified is equal to the current . + + + Compares two RSA Signature paddings to determine if they are identical or not. + + The to compare with the current . + true if the specified is equal to the current + ; otherwise, false. + + + + Determines whether the specified object is equal to the current object. + + + The type of comparison between the current instance and the parameter depends on whether + the current instance is a reference type or a value type. + + The object to compare with the current object. + true if the specified object is equal to the current object; otherwise, false. + + + + Returns the hash code for this instance. + + + Returns the hash code for this instance. + + A hash code for the current object. + + + + Returns a that represents the current + . + + + Creates a string-representation of the . + + A that represents the current + . + + + + Compare two objects for equality. + + + Compares two objects for equality. + + The first object to compare. + The second object to compare. + true if and are equal; otherwise, false. + + + + Compare two objects for inequality. + + + Compares two objects for inequality. + + The first object to compare. + The second object to compare. + true if and are unequal; otherwise, false. + + + + The RSA signature padding schemes used by S/MIME. + + + The RSA signature padding schemes used by S/MIME as described in + rfc8017. + + + + + The PKCS #1 v1.5 signature padding scheme. + + + + + The Probibilistic Signature Scheme (PSS). + + + + + A secure mailbox address which includes a fingerprint for a certificate. + + + When signing or encrypting a message, it is necessary to look up the + X.509 certificate in order to do the actual sign or encrypt operation. One + way of accomplishing this is to use the email address of sender or recipient + as a unique identifier. However, a better approach is to use the fingerprint + (or 'thumbprint' in Microsoft parlance) of the user's certificate. + + + + + Initialize a new instance of the class. + + + Creates a new with the specified fingerprint. + + The character encoding to be used for encoding the name. + The name of the mailbox. + The route of the mailbox. + The address of the mailbox. + The fingerprint of the certificate belonging to the owner of the mailbox. + + is null. + -or- + is null. + -or- + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new with the specified fingerprint. + + The name of the mailbox. + The route of the mailbox. + The address of the mailbox. + The fingerprint of the certificate belonging to the owner of the mailbox. + + is null. + -or- + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new with the specified fingerprint. + + The character encoding to be used for encoding the name. + The name of the mailbox. + The address of the mailbox. + The fingerprint of the certificate belonging to the owner of the mailbox. + + is null. + -or- + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new with the specified fingerprint. + + The name of the mailbox. + The address of the mailbox. + The fingerprint of the certificate belonging to the owner of the mailbox. + + is null. + -or- + is null. + + + + + Gets the fingerprint of the certificate and/or key to use for signing or encrypting. + + + A fingerprint is a SHA-1 hash of the raw certificate data and is often used + as a unique identifier for a particular certificate in a certificate store. + + + + The fingerprint of the certificate. + + + + A Secure MIME (S/MIME) cryptography context. + + + Generally speaking, applications should not use a + directly, but rather via higher level APIs such as + and . + + + + + Initialize a new instance of the class. + + + Enables the following encryption algorithms by default: + + + + + + + + + + + + + + + + Get the signature protocol. + + + The signature protocol is used by + in order to determine what the protocol parameter of the Content-Type + header should be. + + The signature protocol. + + + + Get the encryption protocol. + + + The encryption protocol is used by + in order to determine what the protocol parameter of the Content-Type + header should be. + + The encryption protocol. + + + + Get the key exchange protocol. + + + Gets the key exchange protocol. + + The key exchange protocol. + + + + Check whether or not the specified protocol is supported by the . + + + Used in order to make sure that the protocol parameter value specified in either a multipart/signed + or multipart/encrypted part is supported by the supplied cryptography context. + + true if the protocol is supported; otherwise false + The protocol. + + is null. + + + + + Get the string name of the digest algorithm for use with the micalg parameter of a multipart/signed part. + + + Maps the to the appropriate string identifier + as used by the micalg parameter value of a multipart/signed Content-Type + header. For example: + + AlgorithmName + md2 + md4 + md5 + sha-1 + sha-224 + sha-256 + sha-384 + sha-512 + tiger-192 + ripemd160 + haval-5-160 + + + The micalg value. + The digest algorithm. + + is out of range. + + + The specified is not supported by this context. + + + + + Get the digest algorithm from the micalg parameter value in a multipart/signed part. + + + Maps the micalg parameter value string back to the appropriate . + Maps the micalg parameter value string back to the appropriate + + AlgorithmName + md2 + md4 + md5 + sha-1 + sha-224 + sha-256 + sha-384 + sha-512 + tiger-192 + ripemd160 + haval-5-160 + + + The digest algorithm. + The micalg parameter value. + + is null. + + + + + Get the OID for the digest algorithm. + + + Gets the OID for the digest algorithm. + + The digest oid. + The digest algorithm. + + is out of range. + + + The specified is not supported by this context. + + + + + Get the preferred encryption algorithm to use for encrypting to the specified recipients. + + + Gets the preferred encryption algorithm to use for encrypting to the specified recipients + based on the encryption algorithms supported by each of the recipients, the + , and the + . + If the supported encryption algorithms are unknown for any recipient, it is assumed that + the recipient supports at least the Triple-DES encryption algorithm. + + The preferred encryption algorithm. + The recipients. + + + + Compress the specified stream. + + + Compresses the specified stream. + + A new instance + containing the compressed content. + The stream to compress. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously compress the specified stream. + + + Asynchronously compresses the specified stream. + + A new instance + containing the compressed content. + The stream to compress. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decompress the specified stream. + + + Decompresses the specified stream. + + The decompressed mime part. + The stream to decompress. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decompress the specified stream. + + + Asynchronously decompresses the specified stream. + + The decompressed mime part. + The stream to decompress. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decompress the specified stream to an output stream. + + + Decompresses the specified stream to an output stream. + + The stream to decompress. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decompress the specified stream to an output stream. + + + Asynchronously decompresses the specified stream to an output stream. + + An asynchronous task context. + The stream to decompress. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign and encapsulate the content using the specified signer. + + + Signs and encapsulates the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously sign and encapsulate the content using the specified signer. + + + Asynchronously signs and encapsulates the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Sign and encapsulate the content using the specified signer and digest algorithm. + + + Signs and encapsulates the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign and encapsulate the content using the specified signer and digest algorithm. + + + Asynchronously signs and encapsulates the content using the specified signer and digest algorithm. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign the content using the specified signer. + + + Signs the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Asynchronously sign the content using the specified signer. + + + Asynchronously signs the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + + + Verify the digital signatures of the specified signed data and extract the original content. + + + Verifies the digital signatures of the specified signed data and extracts the original content. + + The list of digital signatures. + The signed data. + The extracted MIME entity. + The cancellation token. + + is null. + + + The extracted content could not be parsed as a MIME entity. + + + The operation was cancelled via the cancellation token. + + + + + Verify the digital signatures of the specified signed data and extract the original content. + + + Verifies the digital signatures of the specified signed data and extracts the original content. + + The extracted content stream. + The signed data. + The digital signatures. + The cancellation token. + + is null. + + + An error occurred in the cryptographic message syntax subsystem. + + + The operation was cancelled via the cancellation token. + + + + + Encrypts the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted content. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously encrypts the specified content for the specified recipients. + + + Asynchronously encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted content. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Decrypts the specified encryptedData to an output stream. + + + Decrypts the specified encryptedData to an output stream. + + The encrypted data. + The stream to write the decrypted data to. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously decrypts the specified encryptedData to an output stream. + + + Asynchronously decrypts the specified encryptedData to an output stream. + + An asynchronous task context. + The encrypted data. + The stream to write the decrypted data to. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Imports certificates and keys from a pkcs12-encoded stream. + + + Imports certificates and keys from a pkcs12-encoded stream. + + The raw certificate and key data. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously imports certificates and keys from a pkcs12-encoded stream. + + + Asynchronously imports certificates and keys from a pkcs12-encoded stream. + + An asynchronous task context. + The raw certificate and key data. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Imports certificates and keys from a pkcs12 file. + + + Imports certificates and keys from a pkcs12 file. + + The raw certificate and key data in pkcs12 format. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + -or- + does not contain a private key. + -or- + does not contain a certificate that could be used for signing. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + An I/O error occurred. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously imports certificates and keys from a pkcs12 file. + + + Asynchronously imports certificates and keys from a pkcs12 file. + + An asynchronous task context. + The raw certificate and key data in pkcs12 format. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + -or- + does not contain a private key. + -or- + does not contain a certificate that could be used for signing. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + An I/O error occurred. + + + Importing keys is not supported by this cryptography context. + + + The operation was cancelled via the cancellation token. + + + + + Import a certificate. + + + Imports a certificate. + + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously import a certificate. + + + Asynchronously imports a certificate. + + An asynchronous task context. + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import a certificate. + + + Imports a certificate. + + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously import a certificate. + + + Asynchronously imports a certificate. + + An asynchronous task context. + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import a certificate revocation list. + + + Imports a certificate revocation list. + + The certificate revocation list. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously import a certificate revocation list. + + + Asynchronously imports a certificate revocation list. + + An asynchronous task context. + The certificate revocation list. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import certificates (as from a certs-only application/pkcs-mime part) + from the specified stream. + + + Imports certificates (as from a certs-only application/pkcs-mime part) + from the specified stream. + + The raw key data. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously import certificates (as from a certs-only application/pkcs-mime part) + from the specified stream. + + + Asynchronously imports certificates (as from a certs-only application/pkcs-mime part) + from the specified stream. + + An asynchronous task context. + The raw key data. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + An S/MIME digital certificate. + + + An S/MIME digital certificate. + + + + + Initialize a new instance of the class. + + + Creates a new . + + An X.509 certificate. + + is null. + + + + + Get the X.509 certificate. + + + Gets the X.509 certificate. + + The certificate. + + + + Gets the public key algorithm supported by the certificate. + + + Gets the public key algorithm supported by the certificate. + + The public key algorithm. + + + + Gets the date that the certificate was created. + + + Gets the date that the certificate was created. + + The creation date. + + + + Gets the expiration date of the certificate. + + + Gets the expiration date of the certificate. + + The expiration date. + + + + Gets the fingerprint of the certificate. + + + Gets the fingerprint of the certificate. + + The fingerprint. + + + + Gets the email address of the owner of the certificate. + + + Gets the email address of the owner of the certificate. + + The email address. + + + + Gets the name of the owner of the certificate. + + + Gets the name of the owner of the certificate. + + The name of the owner. + + + + An S/MIME digital signature. + + + An S/MIME digital signature. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The information about the signer. + The signer's certificate. + + is null. + + + + + Gets the signer info. + + + Gets the signer info. + + The signer info. + + + + Gets the list of encryption algorithms, in preferential order, + that the signer's client supports. + + + Gets the list of encryption algorithms, in preferential order, + that the signer's client supports. + + The S/MIME encryption algorithms. + + + + Gets the certificate chain. + + + If building the certificate chain failed, this value will be null and + will be set. + + The certificate chain. + + + + The exception that occurred, if any, while building the certificate chain. + + + This will only be set if building the certificate chain failed. + + The exception. + + + + Gets certificate used by the signer. + + + Gets certificate used by the signer. + + The signer's certificate. + + + + Gets the public key algorithm used for the signature. + + + Gets the public key algorithm used for the signature. + + The public key algorithm. + + + + Gets the digest algorithm used for the signature. + + + Gets the digest algorithm used for the signature. + + The digest algorithm. + + + + Gets the creation date of the digital signature. + + + Gets the creation date of the digital signature. + + The creation date in coordinated universal time (UTC). + + + + Verifies the digital signature. + + + Verifies the digital signature. + + true if the signature is valid; otherwise, false. + + An error verifying the signature has occurred. + + + + + Verifies the digital signature. + + + Verifies the digital signature. + + true if only the signature itself should be verified; otherwise, both the signature and the certificate chain are validated. + true if the signature is valid; otherwise, false. + + An error verifying the signature has occurred. + + + + + The type of S/MIME data that an application/pkcs7-mime part contains. + + + The type of S/MIME data that an application/pkcs7-mime part contains. + + + + + The S/MIME data type is unknown. + + + + + The S/MIME content is compressed. + + + + + The S/MIME content is encrypted. + + + + + The S/MIME content is signed. + + + + + The S/MIME content contains only certificates. + + + + + The S/MIME content is both signed and encrypted. + + + + + An abstract X.509 certificate database built on generic SQL storage. + + + An X.509 certificate database is used for storing certificates, metdata related to the certificates + (such as encryption algorithms supported by the associated client), certificate revocation lists (CRLs), + and private keys. + This particular database uses SQLite to store the data. + + + + + Initialize a new instance of the class. + + + Creates a new using the provided database connection. + + The database connection. + The password used for encrypting and decrypting the private keys. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new using the provided database connection. + + The database connection. + The password used for encrypting and decrypting the private keys. + The secure pseuido-random number generator. + + is null. + -or- + is null. + -or- + is null. + + + + + Gets the X.509 certificate table definition. + + + Gets the X.509 certificate table definition. + + The X.509 certificates table definition. + + + + Gets the X.509 certificate revocation lists (CRLs) table definition. + + + Gets the X.509 certificate revocation lists (CRLs) table definition. + + The X.509 certificate revocation lists table definition. + + + + Gets the columns for the specified table. + + + Gets the list of columns for the specified table. + + The database connection. + The name of the table. + The list of columns. + + + + Gets the command to create a table. + + + Constructs the command to create a table. + + The database connection. + The table. + + + + Adds a column to a table. + + + Adds a column to a table. + + The database connection. + The table. + The column to add. + + + + Gets the name of an index based on the table and columns that it is built against. + + + Gets the name of an index based on the table and columns that it is built against. + + The name of the table. + The names of the columns that are indexed. + The name of the index for the specified table and columns. + + + + Creates an index for faster table lookups. + + + Creates an index for faster table lookups. + + The database connection. + The name of the table. + The names of the columns to index. + + + + Removes an index that is no longer needed. + + + Removes an index that is no longer needed. + + The database connection. + The name of the table. + The names of the columns that were indexed. + + + + Creates a SELECT query string builder for the specified fields of an X.509 certificate record. + + + Creates a SELECT query string builder for the specified fields of an X.509 certificate record. + + The X.509 certificate fields. + A containing a basic SELECT query string. + + + + Gets the database command to select the record matching the specified certificate. + + + Gets the database command to select the record matching the specified certificate. + + The database command. + The database connection. + The certificate. + The fields to return. + + + + Get the database command to select the certificate records for the specified mailbox. + + + Gets the database command to select the certificate records for the specified mailbox. + + The database command. + The database connection. + The mailbox. + The date and time for which the certificate should be valid. + true + The fields to return. + + + + Get the database command to select the requested certificate records. + + + Gets the database command to select the requested certificate records. + + The database command. + The database connection. + The certificate selector. + true if only trusted anchor certificates should be matched; otherwise, false. + true if the certificate must have a private key; otherwise, false. + The fields to return. + + + + Gets the database command to select the CRL records matching the specified issuer. + + + Gets the database command to select the CRL records matching the specified issuer. + + The database command. + The database connection. + The issuer. + The fields to return. + + + + Gets the database command to select the record for the specified CRL. + + + Gets the database command to select the record for the specified CRL. + + The database command. + The database connection. + The X.509 CRL. + The fields to return. + + + + Gets the database command to select all CRLs in the table. + + + Gets the database command to select all CRLs in the table. + + The database command. + The database connection. + + + + Gets the database command to delete the specified certificate record. + + + Gets the database command to delete the specified certificate record. + + The database command. + The database connection. + The certificate record. + + + + Gets the database command to delete the specified CRL record. + + + Gets the database command to delete the specified CRL record. + + The database command. + The database connection. + The record. + + + + Gets the database command to insert the specified certificate record. + + + Gets the database command to insert the specified certificate record. + + The database command. + The database connection. + The certificate record. + + + + Gets the database command to insert the specified CRL record. + + + Gets the database command to insert the specified CRL record. + + The database command. + The database connection. + The CRL record. + + + + Gets the database command to update the specified record. + + + Gets the database command to update the specified record. + + The database command. + The database connection. + The certificate record. + The fields to update. + + + + Gets the database command to update the specified CRL record. + + + Gets the database command to update the specified CRL record. + + The database command. + The database connection. + The CRL record. + + + + Releases the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + An X.509 certificate database built on SQLite. + + + An X.509 certificate database is used for storing certificates, metdata related to the certificates + (such as encryption algorithms supported by the associated client), certificate revocation lists (CRLs), + and private keys. + This particular database uses SQLite to store the data. + + + + + Initialize a new instance of the class. + + + Creates a new and opens a connection to the + SQLite database at the specified path using the Mono.Data.Sqlite binding to the native + SQLite library. + If Mono.Data.Sqlite is not available or if an alternative binding to the native + SQLite library is preferred, then consider using + instead. + + The file name. + The password used for encrypting and decrypting the private keys. + + is null. + -or- + is null. + + + The specified file path is empty. + + + The user does not have access to read the specified file. + + + An error occurred reading the file. + + + + + Initialize a new instance of the class. + + + Creates a new and opens a connection to the + SQLite database at the specified path using the Mono.Data.Sqlite binding to the native + SQLite library. + If Mono.Data.Sqlite is not available or if an alternative binding to the native + SQLite library is preferred, then consider using + instead. + + The file name. + The password used for encrypting and decrypting the private keys. + The secure pseudo-random number generator. + + is null. + -or- + is null. + -or- + is null. + + + The specified file path is empty. + + + The user does not have access to read the specified file. + + + An error occurred reading the file. + + + + + Initialize a new instance of the class. + + + Creates a new using the provided SQLite database connection. + + The SQLite connection. + The password used for encrypting and decrypting the private keys. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new using the provided SQLite database connection. + + The SQLite connection. + The password used for encrypting and decrypting the private keys. + The secure pseudo-random number generator. + + is null. + -or- + is null. + -or- + is null. + + + + + Gets the columns for the specified table. + + + Gets the list of columns for the specified table. + + The database connection. + The name of the table. + The list of columns. + + + + Create a table. + + + Creates the specified table. + + The database connection. + The table. + + + + Adds a column to a table. + + + Adds a column to a table. + + The database connection. + The table. + The column to add. + + + + An X.509 certificate database built on SQL Server. + + + An X.509 certificate database is used for storing certificates, metdata related to the certificates + (such as encryption algorithms supported by the associated client), certificate revocation lists (CRLs), + and private keys. + This particular database uses SQL Server to store the data. + + + + + Initialize a new instance of the class. + + + Creates a new using the provided SQL Server database connection. + + The SQL Server connection. + The password used for encrypting and decrypting the private keys. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new using the provided SQL Server database connection. + + The SQL Server connection. + The password used for encrypting and decrypting the private keys. + The secure pseudo-random number generator. + + is null. + -or- + is null. + -or- + is null. + + + + + Adds a column to a table. + + + Adds a column to a table. + + The database connection. + The table. + The column to add. + + + + Create a table. + + + Creates the specified table. + + The database connection. + The table. + + + + Gets the columns for the specified table. + + + Gets the list of columns for the specified table. + + The database connection. + The name of the table. + The list of columns. + + + + Creates an index for faster table lookups. + + + Creates an index for faster table lookups. + + The database connection. + The name of the table. + The names of the columns to index. + + + + Removes an index that is no longer needed. + + + Removes an index that is no longer needed. + + The database connection. + The name of the table. + The names of the columns that were indexed. + + + + Gets the database command to select the record matching the specified certificate. + + + Gets the database command to select the record matching the specified certificate. + + The database command. + The database connection. + The certificate. + The fields to return. + + + + Gets the database command to insert the specified certificate record. + + + Gets the database command to insert the specified certificate record. + + The database command. + The database connection. + The certificate record. + + + + The method to use for identifying a certificate. + + + The method to use for identifying a certificate. + + + + + The identifier type is unknown. + + + + + Identify the certificate by its Issuer and Serial Number properties. + + + + + Identify the certificate by the sha1 hash of its public key. + + + + + An S/MIME context that does not persist certificates, private keys or CRLs. + + + A is a special S/MIME context that + does not use a persistent store for certificates, private keys, or CRLs. + Instead, certificates, private keys, and CRLs are maintained in memory only. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Initialize a new instance of the class. + + + Creates a new . + + A secure pseudo-random number generator. + + is null. + + + + + Check whether or not a particular mailbox address can be used for signing. + + + Checks whether or not as particular mailbocx address can be used for signing. + + true if the mailbox address can be used for signing; otherwise, false. + The signer. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Check whether or not the cryptography context can encrypt to a particular recipient. + + + Checks whether or not the cryptography context can be used to encrypt to a particular recipient. + + true if the cryptography context can be used to encrypt to the designated recipient; otherwise, false. + The recipient's mailbox address. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Gets the X.509 certificate matching the specified selector. + + + Gets the first certificate that matches the specified selector. + + The certificate on success; otherwise null. + The search criteria for the certificate. + + + + Gets the private key for the certificate matching the specified selector. + + + Gets the private key for the first certificate that matches the specified selector. + + The private key on success; otherwise null. + The search criteria for the private key. + + + + Gets the trusted anchors. + + + A trusted anchor is a trusted root-level X.509 certificate, + generally issued by a certificate authority (CA). + + The trusted anchors. + + + + Gets the intermediate certificates. + + + An intermediate certificate is any certificate that exists between the root + certificate issued by a Certificate Authority (CA) and the certificate at + the end of the chain. + + The intermediate certificates. + + + + Gets the certificate revocation lists. + + + A Certificate Revocation List (CRL) is a list of certificate serial numbers issued + by a particular Certificate Authority (CA) that have been revoked, either by the CA + itself or by the owner of the revoked certificate. + + The certificate revocation lists. + + + + Get the date & time for the next scheduled certificate revocation list update for the specified issuer. + + + Gets the date & time for the next scheduled certificate revocation list update for the specified issuer. + + The date & time for the next update. + The issuer. + + + + Gets the for the specified mailbox. + + + Constructs a with the appropriate certificate and + for the specified mailbox. + If the mailbox is a , the + property will be used instead of + the mailbox address. + + A . + The mailbox. + + A certificate for the specified could not be found. + + + + + Gets the for the specified mailbox. + + + Constructs a with the appropriate signing certificate + for the specified mailbox. + If the mailbox is a , the + property will be used instead of + the mailbox address for database lookups. + + A . + The mailbox. + The preferred digest algorithm. + + A certificate for the specified could not be found. + + + + + Updates the known S/MIME capabilities of the client used by the recipient that owns the specified certificate. + + + Updates the known S/MIME capabilities of the client used by the recipient that owns the specified certificate. + + The certificate. + The encryption algorithm capabilities of the client (in preferred order). + The timestamp. + + + + Imports certificates and keys from a pkcs12-encoded stream. + + + Imports certificates and keys from a pkcs12-encoded stream. + + The raw certificate and key data in pkcs12 format. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously imports certificates and keys from a pkcs12-encoded stream. + + + Asynchronously imports certificates and keys from a pkcs12-encoded stream. + + Ayn asynchronous task context. + The raw certificate and key data in pkcs12 format. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import a certificate. + + + Imports a certificate. + + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import a certificate. + + + Imports a certificate. + + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import a certificate revocation list. + + + Imports a certificate revocation list. + + The certificate revocation list. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + A Secure MIME (S/MIME) cryptography context. + + + An S/MIME cryptography context that uses + for certificate storage and retrieval. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The X.509 store location. + + + + Initialize a new instance of the class. + + + Constructs an S/MIME context using the current user's X.509 store location. + + + + + Gets the X.509 store location. + + + Gets the X.509 store location. + + The store location. + + + + Check whether or not a particular mailbox address can be used for signing. + + + Checks whether or not as particular mailbocx address can be used for signing. + + true if the mailbox address can be used for signing; otherwise, false. + The signer. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Check whether or not the cryptography context can encrypt to a particular recipient. + + + Checks whether or not the cryptography context can be used to encrypt to a particular recipient. + + true if the cryptography context can be used to encrypt to the designated recipient; otherwise, false. + The recipient's mailbox address. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + + + Get the certificate for the specified recipient. + + + Gets the certificate for the specified recipient. + If the mailbox is a , the + property will be used instead of + the mailbox address. + + The certificate to use for the recipient; otherwise, or null. + The recipient's mailbox address. + + + + Get the for the specified mailbox. + + + Constructs a with + the appropriate certificate for the specified mailbox. + If the mailbox is a , the + property will be used instead of + the mailbox address. + + A . + The recipient's mailbox address. + + A certificate for the specified could not be found. + + + + + Get a collection of for the specified mailboxes. + + + Gets a collection of for the specified mailboxes. + + A . + The recipient mailboxes. + + is null. + + + A certificate for one or more of the specified could not be found. + + + + + Get the certificate for the specified signer. + + + Gets the certificate for the specified signer. + If the mailbox is a , the + property will be used instead of + the mailbox address. + + The certificate to use for the signer; otherwise, or null. + The signer's mailbox address. + + + + Get the for the specified mailbox. + + + Constructs a with + the appropriate signing certificate for the specified mailbox. + If the mailbox is a , the + property will be used instead of + the mailbox address for database lookups. + + A . + The signer's mailbox address. + The preferred digest algorithm. + + A certificate for the specified could not be found. + + + + + Updates the known S/MIME capabilities of the client used by the recipient that owns the specified certificate. + + + Updates the known S/MIME capabilities of the client used by the recipient that owns the specified certificate. + This method is called when decoding digital signatures that include S/MIME capabilities in the metadata, allowing custom + implementations to update the X.509 certificate records with the list of preferred encryption algorithms specified by the + sending client. + + The certificate. + The encryption algorithm capabilities of the client (in preferred order). + The timestamp. + + + + Sign and encapsulate the content using the specified signer. + + + Signs and encapsulates the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign and encapsulate the content using the specified signer. + + + Asynchronously signs and encapsulates the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign and encapsulate the content using the specified signer. + + + Signs and encapsulates the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign and encapsulate the content using the specified signer. + + + Asynchronously signs and encapsulates the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign the content using the specified signer. + + + Signs the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign the content using the specified signer. + + + Asynchronously signs the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Sign the content using the specified signer. + + + Signs the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously sign the content using the specified signer. + + + Asynchronously signs the content using the specified signer. + + A new instance + containing the detached signature data. + The signer. + The digest algorithm to use for signing. + The content. + The cancellation token. + + is null. + -or- + is null. + + + is out of range. + + + The specified is not supported by this context. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Attempts to map a + to a . + + + Attempts to map a + to a . + + true if the algorithm identifier was successfully mapped; otherwise, false. + The algorithm identifier. + The encryption algorithm. + + is null. + + + + + Verify the specified content using the detached signature data. + + + Verifies the specified content using the detached signature data. + + A list of the digital signatures. + The content. + The detached signature data. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously verify the specified content using the detached signature data. + + + Verifies the specified content using the detached signature data. + + A list of the digital signatures. + The content. + The detached signature data. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Verify the digital signatures of the specified signed data and extract the original content. + + + Verifies the digital signatures of the specified signed data and extracts the original content. + + The list of digital signatures. + The signed data. + The extracted MIME entity. + The cancellation token. + + is null. + + + The extracted content could not be parsed as a MIME entity. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Verify the digital signatures of the specified signed data and extract the original content. + + + Verifies the digital signatures of the specified signed data and extracts the original content. + + The extracted content stream. + The signed data. + The digital signatures. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Gets the preferred encryption algorithm to use for encrypting to the specified recipients. + + + Gets the preferred encryption algorithm to use for encrypting to the specified recipients + based on the encryption algorithms supported by each of the recipients, the + , and the + . + If the supported encryption algorithms are unknown for any recipient, it is assumed that + the recipient supports at least the Triple-DES encryption algorithm. + + The preferred encryption algorithm. + The recipients. + + + + Encrypts the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted content. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously encrypts the specified content for the specified recipients. + + + Asynchronously encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted content. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Encrypts the specified content for the specified recipients. + + + Encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + A certificate for one or more of the could not be found. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously encrypts the specified content for the specified recipients. + + + Asynchronously encrypts the specified content for the specified recipients. + + A new instance + containing the encrypted data. + The recipients. + The content. + The cancellation token. + + is null. + -or- + is null. + + + A certificate for one or more of the could not be found. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the . + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decrypt the encrypted data. + + + Decrypt the encrypted data. + + The decrypted . + The encrypted data. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decrypt the encrypted data. + + + Asynchronously decrypt the encrypted data. + + The decrypted . + The encrypted data. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Decrypts the specified encryptedData to an output stream. + + + Decrypts the specified encryptedData to an output stream. + + The encrypted data. + The decrypted data. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously decrypts the specified encryptedData to an output stream. + + + Asynchronously decrypts the specified encryptedData to an output stream. + + An asynchronous task context. + The encrypted data. + The decrypted data. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Import the specified certificate. + + + Import the specified certificate. + + The store to import the certificate into. + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import a certificate. + + + Imports a certificate into the store. + + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import the specified certificate. + + + Import the specified certificate. + + The store to import the certificate into. + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import a certificate. + + + Imports a certificate into the store. + + The certificate. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import a certificate revocation list. + + + Imports a certificate revocation list. + + The certificate revocation list. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import certificates and keys from a pkcs12-encoded stream. + + + Imports certificates and keys from a pkcs12-encoded stream. + + The raw certificate and key data. + The password to unlock the stream. + The storage flags to use when importing the certificate and private key. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously import certificates and keys from a pkcs12-encoded stream. + + + Asynchronously imports certificates and keys from a pkcs12-encoded stream. + + An asynchronous task context. + The raw certificate and key data. + The password to unlock the stream. + The storage flags to use when importing the certificate and private key. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Import certificates and keys from a pkcs12-encoded stream. + + + Imports certificates and keys from a pkcs12-encoded stream. + + The raw certificate and key data. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Asynchronously import certificates and keys from a pkcs12-encoded stream. + + + Asynchronously imports certificates and keys from a pkcs12-encoded stream. + + An asynchronous task context. + The raw certificate and key data. + The password to unlock the stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was cancelled via the cancellation token. + + + + + Exports the certificates for the specified mailboxes. + + + Exports the certificates for the specified mailboxes. + + A new instance containing + the exported keys. + The mailboxes. + The cancellation token. + + is null. + + + No mailboxes were specified. + + + The operation was cancelled via the cancellation token. + + + A certificate for one or more of the could not be found. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + Asynchronously export the certificates for the specified mailboxes. + + + Asynchronously exports the certificates for the specified mailboxes. + + A new instance containing + the exported keys. + The mailboxes. + The cancellation token. + + is null. + + + No mailboxes were specified. + + + The operation was canceled via the cancellation token. + + + A certificate for one or more of the could not be found. + + + An error occurred in the cryptographic message syntax subsystem. + + + + + An S/MIME digital certificate. + + + An S/MIME digital certificate that is used with the . + + + + + Initialize a new instance of the class. + + + Creates a new . + + An X.509 certificate. + + is null. + + + + + Get the X.509 certificate. + + + Gets the X.509 certificate. + + The certificate. + + + + Gets the public key algorithm supported by the certificate. + + + Gets the public key algorithm supported by the certificate. + + The public key algorithm. + + + + Gets the date that the certificate was created. + + + Gets the date that the certificate was created. + + The creation date. + + + + Gets the expiration date of the certificate. + + + Gets the expiration date of the certificate. + + The expiration date. + + + + Gets the fingerprint of the certificate. + + + Gets the fingerprint of the certificate. + + The fingerprint. + + + + Gets the email address of the owner of the certificate. + + + Gets the email address of the owner of the certificate. + + The email address. + + + + Gets the name of the owner of the certificate. + + + Gets the name of the owner of the certificate. + + The name of the owner. + + + + An S/MIME digital signature. + + + An S/MIME digital signature that is used with the . + + + + + Initialize a new instance of the class. + + + Creates a new . + + The information about the signer. + + is null. + + + + + Gets the signer info. + + + Gets the signer info. + + The signer info. + + + + Gets the list of encryption algorithms, in preferential order, + that the signer's client supports. + + + Gets the list of encryption algorithms, in preferential order, + that the signer's client supports. + + The S/MIME encryption algorithms. + + + + Gets certificate used by the signer. + + + Gets certificate used by the signer. + + The signer's certificate. + + + + Gets the public key algorithm used for the signature. + + + Gets the public key algorithm used for the signature. + + The public key algorithm. + + + + Gets the digest algorithm used for the signature. + + + Gets the digest algorithm used for the signature. + + The digest algorithm. + + + + Gets the creation date of the digital signature. + + + Gets the creation date of the digital signature. + + The creation date in coordinated universal time (UTC). + + + + Verifies the digital signature. + + + Verifies the digital signature. + + true if the signature is valid; otherwise false. + + An error verifying the signature has occurred. + + + + + Verifies the digital signature. + + + Verifies the digital signature. + + true if only the signature itself should be verified; otherwise, both the signature and the certificate chain are validated. + true if the signature is valid; otherwise, false. + + An error verifying the signature has occurred. + + + + + Extension methods for X509Certificate2. + + + Extension methods for X509Certificate2. + + + + + Convert an X509Certificate2 into a BouncyCastle X509Certificate. + + + Converts an X509Certificate2 into a BouncyCastle X509Certificate. + + The bouncy castle certificate. + The certificate. + + is null. + + + + + Gets the public key algorithm for the certificate. + + + Gets the public key algorithm for the ceretificate. + + The public key algorithm. + The certificate. + + is null. + + + + + Get the encryption algorithms that can be used with an X.509 certificate. + + + Scans the X.509 certificate for the S/MIME capabilities extension. If found, + the supported encryption algorithms will be decoded and returned. + If no extension can be found, the + algorithm is returned. + + The encryption algorithms. + The X.509 certificate. + + is null. + + + + + Get the PrivateKey property as a BouncyCastle AsymmetricKeyParameter. + + + Gets the PrivateKey property as a BouncyCastle AsymmetricKeyParameter. + + The asymmetric key parameter. + The X.509 certificate. + + is null. + + + + + An X.509 certificate chain. + + + An X.509 certificate chain. + + + + + Initialize a new instance of the class. + + + Creates a new X.509 certificate chain. + + + + + Initialize a new instance of the class. + + + Creates a new X.509 certificate chain based on the specified collection of certificates. + + A collection of certificates. + + is null. + + + + + Gets the index of the specified certificate within the chain. + + + Finds the index of the specified certificate, if it exists. + + The index of the specified certificate if found; otherwise -1. + The certificate to get the index of. + + is null. + + + + + Inserts the certificate at the specified index. + + + Inserts the certificate at the specified index in the certificates. + + The index to insert the certificate. + The certificate. + + is null. + + + is out of range. + + + + + Removes the certificate at the specified index. + + + Removes the certificate at the specified index. + + The index of the certificate to remove. + + is out of range. + + + + + Gets or sets the certificate at the specified index. + + + Gets or sets the certificate at the specified index. + + The internet certificate at the specified index. + The index of the certificate to get or set. + + is null. + + + is out of range. + + + + + Gets the number of certificates in the chain. + + + Indicates the number of certificates in the chain. + + The number of certificates. + + + + Get a value indicating whether the is read only. + + + A is never read-only. + + true if this instance is read only; otherwise, false. + + + + Adds the specified certificate to the chain. + + + Adds the specified certificate to the chain. + + The certificate. + + is null. + + + + + Adds the specified range of certificates to the chain. + + + Adds the specified range of certificates to the chain. + + The certificates. + + is null. + + + + + Clears the certificate chain. + + + Removes all of the certificates from the chain. + + + + + Checks if the chain contains the specified certificate. + + + Determines whether or not the certificate chain contains the specified certificate. + + true if the specified certificate exists; + otherwise false. + The certificate. + + is null. + + + + + Copies all of the certificates in the chain to the specified array. + + + Copies all of the certificates within the chain into the array, + starting at the specified array index. + + The array to copy the certificates to. + The index into the array. + + is null. + + + is out of range. + + + + + Removes the specified certificate from the chain. + + + Removes the specified certificate from the chain. + + true if the certificate was removed; otherwise false. + The certificate. + + is null. + + + + + Removes the specified range of certificates from the chain. + + + Removes the specified range of certificates from the chain. + + The certificates. + + is null. + + + + + Gets an enumerator for the list of certificates. + + + Gets an enumerator for the list of certificates. + + The enumerator. + + + + Gets an enumerator for the list of certificates. + + + Gets an enumerator for the list of certificates. + + The enumerator. + + + + Gets an enumerator of matching X.509 certificates based on the specified selector. + + + Gets an enumerator of matching X.509 certificates based on the specified selector. + + The matching certificates. + The match criteria. + + + + Gets a collection of matching X.509 certificates based on the specified selector. + + + Gets a collection of matching X.509 certificates based on the specified selector. + + The matching certificates. + The match criteria. + + + + An X.509 certificate database. + + + An X.509 certificate database is used for storing certificates, metadata related to the certificates + (such as encryption algorithms supported by the associated client), certificate revocation lists (CRLs), + and private keys. + + + + + Initialize a new instance of the class. + + + The password is used to encrypt and decrypt private keys in the database and cannot be null. + + The database connection. + The password used for encrypting and decrypting the private keys. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + The password is used to encrypt and decrypt private keys in the database and cannot be null. + + The database connection. + The password used for encrypting and decrypting the private keys. + The secure pseudo-random number generator. + + is null. + -or- + is null. + -or- + is null. + + + + + Releases unmanaged resources and performs other cleanup operations before the + is reclaimed by garbage collection. + + + Releases unmanaged resources and performs other cleanup operations before the + is reclaimed by garbage collection. + + + + + Gets or sets the algorithm used for encrypting the private keys. + + + The encryption algorithm should be one of the PBE (password-based encryption) algorithms + supported by Bouncy Castle. + The default algorithm is SHA-256 + AES256. + + The encryption algorithm. + + + + Gets or sets the minimum iterations. + + + The default minimum number of iterations is 1024. + + The minimum iterations. + + + + Get the secure pseudo-random number generator used when encrypting private keys. + + + Gets the secure pseudo-random number generator used when encrypting private keys. + + The secure pseudo-random number generator. + + + + Gets or sets the size of the salt. + + + The default salt size is 20. + + The size of the salt. + + + + Gets the column names for the specified fields. + + + Gets the column names for the specified fields. + + The column names. + The fields. + + + + Gets the database command to select the record matching the specified certificate. + + + Gets the database command to select the record matching the specified certificate. + + The database command. + The database connection. + The certificate. + The fields to return. + + + + Gets the database command to select the certificate records for the specified mailbox. + + + Gets the database command to select the certificate records for the specified mailbox. + + The database command. + The database connection. + The mailbox. + The date and time for which the certificate should be valid. + true if the certificate must have a private key; otherwise, false. + The fields to return. + + + + Gets the database command to select certificate records matching the specified selector. + + + Gets the database command to select certificate records matching the specified selector. + + The database command. + The database connection. + The certificate selector. + true if only trusted anchor certificates should be matched; otherwise, false. + true if the certificate must have a private key; otherwise, false. + The fields to return. + + + + Gets the column names for the specified fields. + + + Gets the column names for the specified fields. + + The column names. + The fields. + + + + Gets the database command to select the CRL records matching the specified issuer. + + + Gets the database command to select the CRL records matching the specified issuer. + + The database command. + The database connection. + The issuer. + The fields to return. + + + + Gets the database command to select the record for the specified CRL. + + + Gets the database command to select the record for the specified CRL. + + The database command. + The database connection. + The X.509 CRL. + The fields to return. + + + + Gets the database command to select all CRLs in the table. + + + Gets the database command to select all CRLs in the table. + + The database command. + The database connection. + + + + Gets the database command to delete the specified certificate record. + + + Gets the database command to delete the specified certificate record. + + The database command. + The database connection. + The certificate record. + + + + Gets the database command to delete the specified CRL record. + + + Gets the database command to delete the specified CRL record. + + The database command. + The database connection. + The record. + + + + Gets the value for the specified column. + + + Gets the value for the specified column. + + The value. + The certificate record. + The column name. + + is not a known column name. + + + + + Gets the value for the specified column. + + + Gets the value for the specified column. + + The value. + The CRL record. + The column name. + + is not a known column name. + + + + + Gets the database command to insert the specified certificate record. + + + Gets the database command to insert the specified certificate record. + + The database command. + The database connection. + The certificate record. + + + + Gets the database command to insert the specified CRL record. + + + Gets the database command to insert the specified CRL record. + + The database command. + The database connection. + The CRL record. + + + + Gets the database command to update the specified record. + + + Gets the database command to update the specified record. + + The database command. + The database connection. + The certificate record. + The fields to update. + + + + Gets the database command to update the specified CRL record. + + + Gets the database command to update the specified CRL record. + + The database command. + The database connection. + The CRL record. + + + + Find the specified certificate. + + + Searches the database for the specified certificate, returning the matching + record with the desired fields populated. + + The matching record if found; otherwise null. + The certificate. + The desired fields. + + is null. + + + + + Finds the certificates matching the specified selector. + + + Searches the database for certificates matching the selector, returning all + matching certificates. + + The matching certificates. + The match selector or null to return all certificates. + + + + Finds the private keys matching the specified selector. + + + Searches the database for certificate records matching the selector, returning the + private keys for each matching record. + + The matching certificates. + The match selector or null to return all private keys. + + + + Finds the certificate records for the specified mailbox. + + + Searches the database for certificates matching the specified mailbox that are valid + for the date and time specified, returning all matching records populated with the + desired fields. + + The matching certificate records populated with the desired fields. + The mailbox. + The date and time. + true if a private key is required. + The desired fields. + + is null. + + + + + Finds the certificate records matching the specified selector. + + + Searches the database for certificate records matching the selector, returning all + of the matching records populated with the desired fields. + + The matching certificate records populated with the desired fields. + The match selector or null to match all certificates. + true if only trusted anchor certificates should be returned. + The desired fields. + + + + Add the specified certificate record. + + + Adds the specified certificate record to the database. + + The certificate record. + + is null. + + + + + Remove the specified certificate record. + + + Removes the specified certificate record from the database. + + The certificate record. + + is null. + + + + + Update the specified certificate record. + + + Updates the specified fields of the record in the database. + + The certificate record. + The fields to update. + + is null. + + + + + Finds the CRL records for the specified issuer. + + + Searches the database for CRL records matching the specified issuer, returning + all matching records populated with the desired fields. + + The matching CRL records populated with the desired fields. + The issuer. + The desired fields. + + is null. + + + + + Finds the specified certificate revocation list. + + + Searches the database for the specified CRL, returning the matching record with + the desired fields populated. + + The matching record if found; otherwise null. + The certificate revocation list. + The desired fields. + + is null. + + + + + Add the specified CRL record. + + + Adds the specified CRL record to the database. + + The CRL record. + + is null. + + + + + Remove the specified CRL record. + + + Removes the specified CRL record from the database. + + The CRL record. + + is null. + + + + + Update the specified CRL record. + + + Updates the specified fields of the record in the database. + + The CRL record. + + is null. + + + + + Gets a certificate revocation list store. + + + Gets a certificate revocation list store. + + A certificate revocation list store. + + + + Gets a collection of matching certificates matching the specified selector. + + + Gets a collection of matching certificates matching the specified selector. + + The matching certificates. + The match criteria. + + + + Releases the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + Releases all resource used by the object. + + Call when you are finished using the + . The method leaves the + in an unusable state. After calling + , you must release all references to the + so the garbage collector can reclaim the memory that + the was occupying. + + + + X.509 certificate record fields. + + + The record fields are used when querying the + for certificates. + + + + + The "id" field is typically just the ROWID in the database. + + + + + The "trusted" field is a boolean value indicating whether the certificate + is trusted. + + + + + The "algorithms" field is used for storing the last known list of + values that are supported by the + client associated with the certificate. + + + + + The "algorithms updated" field is used to store the timestamp of the + most recent update to the Algorithms field. + + + + + The "certificate" field is sued for storing the binary data of the actual + certificate. + + + + + The "private key" field is used to store the encrypted binary data of the + private key associated with the certificate, if available. + + + + + An X.509 certificate record. + + + Represents an X.509 certificate record loaded from a database. + + + + + Gets the identifier. + + + The id is typically the ROWID of the certificate in the database and is not + generally useful outside of the internals of the database implementation. + + The identifier. + + + + Gets the basic constraints of the certificate. + + + Gets the basic constraints of the certificate. + + The basic constraints of the certificate. + + + + Gets or sets a value indicating whether the certificate is trusted. + + + Indiciates whether or not the certificate is trusted. + + true if the certificate is trusted; otherwise, false. + + + + Gets whether or not the certificate is an anchor. + + + Gets whether or not the certificate is an anchor. + + true if the certificate is an anchor; otherwise, false. + + + + Gets the key usage flags for the certificate. + + + Gets the key usage flags for the certificate. + + The X.509 key usage. + + + + Gets the starting date and time where the certificate is valid. + + + Gets the starting date and time where the certificate is valid. + + The date and time in coordinated universal time (UTC). + + + + Gets the end date and time where the certificate is valid. + + + Gets the end date and time where the certificate is valid. + + The date and time in coordinated universal time (UTC). + + + + Gets the certificate's issuer name. + + + Gets the certificate's issuer name. + + The certificate's issuer name. + + + + Gets the serial number of the certificate. + + + Gets the serial number of the certificate. + + The serial number. + + + + Gets the certificate's subject name. + + + Gets the certificate's subject name. + + The certificate's subject name. + + + + Gets the certificate's subject key identifier. + + + Gets the certificate's subject key identifier. + + The certificate's subject key identifier. + + + + Gets the subject email address. + + + Gets the subject email address. + + The subject email address. + + + + Gets the fingerprint of the certificate. + + + Gets the fingerprint of the certificate. + + The fingerprint. + + + + Gets or sets the encryption algorithm capabilities. + + + Gets or sets the encryption algorithm capabilities. + + The encryption algorithms. + + + + Gets or sets the date when the algorithms were last updated. + + + Gets or sets the date when the algorithms were last updated. + + The date the algorithms were updated. + + + + Gets the certificate. + + + Gets the certificate. + + The certificate. + + + + Gets the private key. + + + Gets the private key. + + The private key. + + + + Initialize a new instance of the class. + + + Creates a new certificate record with a private key for storing in a + . + + The certificate. + The private key. + + is null. + -or- + is null. + + + is not a private key. + + + + + Initialize a new instance of the class. + + + Creates a new certificate record for storing in a . + + The certificate. + + is null. + + + + + Initialize a new instance of the class. + + + This constructor is only meant to be used by implementors of + when loading records from the database. + + + + + A store for X.509 certificates and keys. + + + A store for X.509 certificates and keys. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Enumerates the certificates currently in the store. + + + Enumerates the certificates currently in the store. + + The certificates. + + + + Gets the private key for the specified certificate. + + + Gets the private key for the specified certificate, if it exists. + + The private key on success; otherwise null. + The certificate. + + + + Adds the specified certificate to the store. + + + Adds the specified certificate to the store. + + The certificate. + + is null. + + + + + Adds the specified range of certificates to the store. + + + Adds the specified range of certificates to the store. + + The certificates. + + is null. + + + + + Removes the specified certificate from the store. + + + Removes the specified certificate from the store. + + The certificate. + + is null. + + + + + Removes the specified range of certificates from the store. + + + Removes the specified range of certificates from the store. + + The certificates. + + is null. + + + + + Imports the certificate(s) from the specified stream. + + + Imports the certificate(s) from the specified stream. + + The stream to import. + + is null. + + + An error occurred reading the stream. + + + + + Imports the certificate(s) from the specified file. + + + Imports the certificate(s) from the specified file. + + The name of the file to import. + + is null. + + + The specified file could not be found. + + + An error occurred reading the file. + + + + + Imports the certificate(s) from the specified byte array. + + + Imports the certificate(s) from the specified byte array. + + The raw certificate data. + + is null. + + + + + Imports certificates and private keys from the specified stream. + + + Imports certificates and private keys from the specified pkcs12 stream. + + The stream to import. + The password to unlock the stream. + + is null. + -or- + is null. + + + An error occurred reading the stream. + + + + + Imports certificates and private keys from the specified file. + + + Imports certificates and private keys from the specified pkcs12 stream. + + The name of the file to import. + The password to unlock the file. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The specified file could not be found. + + + The user does not have access to read the specified file. + + + An error occurred reading the file. + + + + + Imports certificates and private keys from the specified byte array. + + + Imports certificates and private keys from the specified pkcs12 stream. + + The raw certificate data. + The password to unlock the raw data. + + is null. + -or- + is null. + + + + + Exports the certificates to an unencrypted stream. + + + Exports the certificates to an unencrypted stream. + + The output stream. + + is null. + + + An error occurred while writing to the stream. + + + + + Exports the certificates to an unencrypted file. + + + Exports the certificates to an unencrypted file. + + The file path to write to. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The specified path exceeds the maximum allowed path length of the system. + + + A directory in the specified path does not exist. + + + The user does not have access to create the specified file. + + + An error occurred while writing to the stream. + + + + + Exports the specified stream and password to a pkcs12 encrypted file. + + + Exports the specified stream and password to a pkcs12 encrypted file. + + The output stream. + The password to use to lock the private keys. + + is null. + -or- + is null. + + + An error occurred while writing to the stream. + + + + + Exports the specified stream and password to a pkcs12 encrypted file. + + + Exports the specified stream and password to a pkcs12 encrypted file. + + The file path to write to. + The password to use to lock the private keys. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The specified path exceeds the maximum allowed path length of the system. + + + A directory in the specified path does not exist. + + + The user does not have access to create the specified file. + + + An error occurred while writing to the stream. + + + + + Gets an enumerator of matching X.509 certificates based on the specified selector. + + + Gets an enumerator of matching X.509 certificates based on the specified selector. + + The matching certificates. + The match criteria. + + + + Gets a collection of matching X.509 certificates based on the specified selector. + + + Gets a collection of matching X.509 certificates based on the specified selector. + + The matching certificates. + The match criteria. + + + + X.509 certificate revocation list record fields. + + + The record fields are used when querying the + for certificate revocation lists. + + + + + The "id" field is typically just the ROWID in the database. + + + + + The "delta" field is a boolean value indicating whether the certificate + revocation list is a delta. + + + + + The "issuer name" field stores the issuer name of the certificate revocation list. + + + + + The "this update" field stores the date and time of the most recent update. + + + + + The "next update" field stores the date and time of the next scheduled update. + + + + + The "crl" field stores the raw binary data of the certificate revocation list. + + + + + An X.509 certificate revocation list (CRL) record. + + + Represents an X.509 certificate revocation list record loaded from a database. + + + + + Gets the identifier. + + + The id is typically the ROWID of the certificate revocation list in the + database and is not generally useful outside of the internals of the + database implementation. + + The identifier. + + + + Gets whether or not this certificate revocation list is a delta. + + + Indicates whether or not this certificate revocation list is a delta. + + true if th crl is delta; otherwise, false. + + + + Gets the issuer name of the certificate revocation list. + + + Gets the issuer name of the certificate revocation list. + + The issuer's name. + + + + Gets the date and time of the most recent update. + + + Gets the date and time of the most recent update. + + The date and time. + + + + Gets the date and time when the next CRL update will be published. + + + Gets the date and time when the next CRL update will be published. + + The date and time. + + + + Gets the certificate revocation list. + + + Gets the certificate revocation list. + + The certificate revocation list. + + + + Initialize a new instance of the class. + + + Creates a new CRL record for storing in a . + + The certificate revocation list. + + is null. + + + + + Initialize a new instance of the class. + + + This constructor is only meant to be used by implementors of + when loading records from the database. + + + + + X.509 key usage flags. + + + The X.509 Key Usage Flags can be used to determine what operations + a certificate can be used for. + A value of indicates that + there are no restrictions on the use of the + . + + + + + No limitations for the key usage are set. + + + The key may be used for anything. + + + + + The key may only be used for enciphering data during key agreement. + + + When both the bit and the + bit are both set, the key + may be used only for enciphering data while + performing key agreement. + + + + + The key may be used for verifying signatures on + certificate revocation lists (CRLs). + + + + + The key may be used for verifying signatures on certificates. + + + + + The key is meant to be used for key agreement. + + + + + The key may be used for data encipherment. + + + + + The key is meant to be used for key encipherment. + + + + + The key may be used to verify digital signatures used to + provide a non-repudiation service. + + + + + The key may be used for digitally signing data. + + + + + The key may only be used for deciphering data during key agreement. + + + When both the bit and the + bit are both set, the key + may be used only for deciphering data while + performing key agreement. + + + + + A domain list. + + + Represents a list of domains, such as those that an email was routed through. + + + + + Initialize a new instance of the class. + + + Creates a new based on the domains provided. + + A domain list. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Get the index of the requested domain, if it exists. + + + Finds the index of the specified domain, if it exists. + + The index of the requested domain; otherwise -1. + The domain. + + is null. + + + + + Insert a domain at the specified index. + + + Inserts the domain at the specified index in the list. + + The index to insert the domain. + The domain to insert. + + is null. + + + is out of range. + + + + + Remove the domain at the specified index. + + + Removes the domain at the specified index. + + The index. + + is out of range. + + + + + Get or set the domain at the specified index. + + + Gets or sets the domain at the specified index. + + The domain at the specified index. + The index. + + is null. + + + is out of range. + + + + + Add a domain. + + + Adds the specified domain to the end of the list. + + The domain. + + is null. + + + + + Clear the domain list. + + + Removes all of the domains in the list. + + + + + Check if the contains the specified domain. + + + Determines whether or not the domain list contains the specified domain. + + true if the specified domain is contained; + otherwise false. + The domain. + + is null. + + + + + Copy all of the domains in the to an array. + + + Copies all of the domains within the into the array, + starting at the specified array index. + + The array to copy the domains to. + The index into the array. + + is null. + + + is out of range. + + + + + Remove a domain. + + + Removes the first instance of the specified domain from the list if it exists. + + true if the domain was removed; otherwise false. + The domain. + + is null. + + + + + Get the number of domains in the . + + + Indicates the number of domains in the list. + + The number of domains. + + + + Get a value indicating whether the is read only. + + + A is never read-only. + + true if this instance is read only; otherwise, false. + + + + Get an enumerator for the list of domains. + + + Gets an enumerator for the list of domains. + + The enumerator. + + + + Get an enumerator for the list of domains. + + + Gets an enumerator for the list of domains. + + The enumerator. + + + + Return a string representation of the list of domains. + + + Each non-empty domain string will be prepended by an '@'. + If there are multiple domains in the list, they will be separated by a comma. + + A string representing the . + + + + Try to parse a list of domains. + + + Attempts to parse a from the text buffer starting at the + specified index. The index will only be updated if a was + successfully parsed. + + true if a was successfully parsed; + false otherwise. + The buffer to parse. + The index to start parsing. + An index of the end of the input. + A flag indicating whether or not an + exception should be thrown on error. + The parsed DomainList. + + + + Try to parse a list of domains. + + + Attempts to parse a from the supplied text. The index + will only be updated if a was successfully parsed. + + true if a was successfully parsed; + false otherwise. + The text to parse. + The parsed DomainList. + + is null. + + + + + A content encoding constraint. + + + Not all message transports support binary or 8-bit data, so it becomes + necessary to constrain the content encoding to a subset of the possible + Content-Transfer-Encoding values. + + + + + There are no encoding constraints, the content may contain any byte. + + + + + The content may contain bytes with the high bit set, but must not contain any zero-bytes. + + + + + The content may only contain bytes within the 7-bit ASCII range. + + + + + Incrementally decodes content encoded with the base64 encoding. + + + Base64 is an encoding often used in MIME to encode binary content such + as images and other types of multi-media to ensure that the data remains + intact when sent via 7bit transports such as SMTP. + + + + + Initialize a new instance of the class. + + + Creates a new base64 decoder. + + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current decoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the decoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to decode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + A pointer to the beginning of the input buffer. + The length of the input buffer. + A pointer to the beginning of the output buffer. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the decoder. + + + Resets the state of the decoder. + + + + + Incrementally encodes content using the base64 encoding. + + + Base64 is an encoding often used in MIME to encode binary content such + as images and other types of multi-media to ensure that the data remains + intact when sent via 7bit transports such as SMTP. + + + + + Initialize a new instance of the class. + + + Creates a new base64 encoder. + + true if this encoder will be used to encode rfc2047 encoded-word payloads; false otherwise. + The maximum number of octets allowed per line (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + + + + + Initialize a new instance of the class. + + + Creates a new base64 encoder. + + The maximum number of octets allowed per line (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current encoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the encoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to encode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Encode the specified input into the output buffer. + + + Encodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Encode the specified input into the output buffer, flushing any internal buffer state as well. + + + Encodes the specified input into the output buffer, flusing any internal state as well. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the encoder. + + + Resets the state of the encoder. + + + + + Incrementally decodes content encoded with a Uri hex encoding. + + + This is mostly meant for decoding parameter values encoded using + the rules specified by rfc2184 and rfc2231. + + + + + Initialize a new instance of the class. + + + Creates a new hex decoder. + + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current decoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the decoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to decode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + A pointer to the beginning of the input buffer. + The length of the input buffer. + A pointer to the beginning of the output buffer. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the decoder. + + + Resets the state of the decoder. + + + + + Incrementally encodes content using a Uri hex encoding. + + + This is mostly meant for decoding parameter values encoded using + the rules specified by rfc2184 and rfc2231. + + + + + Initialize a new instance of the class. + + + Creates a new hex encoder. + + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current encoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the encoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to encode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Encode the specified input into the output buffer. + + + Encodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Encode the specified input into the output buffer, flushing any internal buffer state as well. + + + Encodes the specified input into the output buffer, flusing any internal state as well. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the encoder. + + + Resets the state of the encoder. + + + + + An interface for incrementally decoding content. + + + An interface for incrementally decoding content. + + + + + Get the encoding. + + + Gets the encoding that the decoder supports. + + The encoding. + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current decoder. + + A new with identical state. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to decode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + A pointer to the beginning of the input buffer. + The length of the input buffer. + A pointer to the beginning of the output buffer. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the decoder. + + + Resets the state of the decoder. + + + + + An interface for incrementally encoding content. + + + An interface for incrementally encoding content. + + + + + Get the encoding. + + + Gets the encoding that the encoder supports. + + The encoding. + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current encoder. + + A new with identical state. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to encode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Encode the specified input into the output buffer. + + + Encodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Encode the specified input into the output buffer, flushing any internal buffer state as well. + + + Encodes the specified input into the output buffer, flusing any internal state as well. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the encoder. + + + Resets the state of the encoder. + + + + + An interface for encoding and decoding international domain names. + + + An interface for encoding and decoding international domain names. + + + + + Encode a Unicode domain name, converting it to an ASCII-safe representation. + + + Encodes a Unicode domain name, converting it to an ASCII-safe representation + according to the rules defined by the IDNA standard. + + The Unicode domain name. + The ASCII-encoded domain name. + + + + Encode a Unicode domain name, converting it to an ASCII-safe representation. + + + Encodes a Unicode domain name, converting it to an ASCII-safe representation + according to the rules defined by the IDNA standard. + + The Unicode domain name. + A zero-based offset into that + specifies the start of the substring to convert. The conversion operation continues + to the end of the string. + The ASCII-encoded domain name. + + + + Encode a Unicode domain name, converting it to an ASCII-safe representation. + + + Encodes a Unicode domain name, converting it to an ASCII-safe representation + according to the rules defined by the IDNA standard. + + The Unicode domain name. + A zero-based offset into that + specifies the start of the substring to convert. The conversion operation continues + to the end of the string. + The number of characters to convert in the substring that starts + at the position specified by in the + string. + The ASCII-encoded domain name. + + + + Decode a domain name, converting it to a string of Unicode characters. + + + Decodes a domain name, converting it to Unicode, according to the rules defined by the IDNA standard. + + The ASCII-encoded domain name. + The Unicode domain name. + + + + Decode a domain name, converting it to a string of Unicode characters. + + + Decodes a domain name, converting it to Unicode, according to the rules defined by the IDNA standard. + + The ASCII-encoded domain name. + A zero-based offset into that + specifies the start of the substring to convert. The conversion operation continues + to the end of the string. + The Unicode domain name. + + + + Decode a domain name, converting it to a string of Unicode characters. + + + Decodes a domain name, converting it to Unicode, according to the rules defined by the IDNA standard. + + The ASCII-encoded domain name. + A zero-based offset into that + specifies the start of the substring to convert. The conversion operation continues + to the end of the string. + The number of characters to convert in the substring that starts + at the position specified by in the + string. + The Unicode domain name. + + + + A pass-through decoder implementing the interface. + + + Simply copies data as-is from the input buffer into the output buffer. + + + + + Initialize a new instance of the class. + + The encoding to return in the property. + + Creates a new pass-through decoder. + + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current decoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the decoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to decode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Decode the specified input into the output buffer. + + + Copies the input buffer into the output buffer, verbatim. + + The number of bytes written to the output buffer. + A pointer to the beginning of the input buffer. + The length of the input buffer. + A pointer to the beginning of the output buffer. + + + + Decode the specified input into the output buffer. + + + Copies the input buffer into the output buffer, verbatim. + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the decoder. + + + Resets the state of the decoder. + + + + + A pass-through encoder implementing the interface. + + + Simply copies data as-is from the input buffer into the output buffer. + + + + + Initialize a new instance of the class. + + The encoding to return in the property. + + Creates a new pass-through encoder. + + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current encoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the encoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to encode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Encode the specified input into the output buffer. + + + Copies the input buffer into the output buffer, verbatim. + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Encode the specified input into the output buffer, flushing any internal buffer state as well. + + + Copies the input buffer into the output buffer, verbatim. + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the encoder. + + + Resets the state of the encoder. + + + + + A class for encoding and decoding international domain names. + + + A class for encoding and decoding international domain names. + + + + + Initialize a new instance of the class. + + + Creates a new instance of . + + + + + Initialize a new instance of the class. + + + Creates a new instance of . + + The to use for encoding and decoding international domain names. + + is null. + + + + + Encode a Unicode domain name, converting it to an ASCII-safe representation. + + + Encodes a Unicode domain name, converting it to an ASCII-safe representation + according to the rules defined by the IDNA standard. + + The Unicode domain name. + The ASCII-encoded domain name. + + + + Encode a Unicode domain name, converting it to an ASCII-safe representation. + + + Encodes a Unicode domain name, converting it to an ASCII-safe representation + according to the rules defined by the IDNA standard. + + The Unicode domain name. + A zero-based offset into that + specifies the start of the substring to convert. The conversion operation continues + to the end of the string. + The ASCII-encoded domain name. + + + + Encode a Unicode domain name, converting it to an ASCII-safe representation. + + + Encodes a Unicode domain name, converting it to an ASCII-safe representation + according to the rules defined by the IDNA standard. + + The Unicode domain name. + A zero-based offset into that + specifies the start of the substring to convert. The conversion operation continues + to the end of the string. + The number of characters to convert in the substring that starts + at the position specified by in the + string. + The ASCII-encoded domain name. + + + + Decode a domain name, converting it to a string of Unicode characters. + + + Decodes a domain name, converting it to Unicode, according to the rules defined by the IDNA standard. + + The ASCII-encoded domain name. + The Unicode domain name. + + + + Decode a domain name, converting it to a string of Unicode characters. + + + Decodes a domain name, converting it to Unicode, according to the rules defined by the IDNA standard. + + The ASCII-encoded domain name. + A zero-based offset into that + specifies the start of the substring to convert. The conversion operation continues + to the end of the string. + The Unicode domain name. + + + + Decode a domain name, converting it to a string of Unicode characters. + + + Decodes a domain name, converting it to Unicode, according to the rules defined by the IDNA standard. + + The ASCII-encoded domain name. + A zero-based offset into that + specifies the start of the substring to convert. The conversion operation continues + to the end of the string. + The number of characters to convert in the substring that starts + at the position specified by in the + string. + The Unicode domain name. + + + + Q-Encoding mode. + + + The encoding mode for the 'Q' encoding used in rfc2047. + + + + + A mode for encoding phrases, as defined by rfc822. + + + + + A mode for encoding text. + + + + + Incrementally encodes content using a variation of the quoted-printable encoding + that is specifically meant to be used for rfc2047 encoded-word tokens. + + + The Q-Encoding is an encoding often used in MIME to encode textual content outside + of the ASCII range within an rfc2047 encoded-word token in order to ensure that + the text remains intact when sent via 7bit transports such as SMTP. + + + + + Initialize a new instance of the class. + + + Creates a new rfc2047 quoted-printable encoder. + + The rfc2047 encoding mode. + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current encoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the encoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to encode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Encode the specified input into the output buffer. + + + Encodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Encode the specified input into the output buffer, flushing any internal buffer state as well. + + + Encodes the specified input into the output buffer, flusing any internal state as well. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the encoder. + + + Resets the state of the encoder. + + + + + Incrementally decodes content encoded with the quoted-printable encoding. + + + Quoted-Printable is an encoding often used in MIME to textual content outside + of the ASCII range in order to ensure that the text remains intact when sent + via 7bit transports such as SMTP. + + + + + Initialize a new instance of the class. + + + Creates a new quoted-printable decoder. + + true if this decoder will be used to decode rfc2047 encoded-word tokens; otherwise, false. + + + + Initialize a new instance of the class. + + + Creates a new quoted-printable decoder. + + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current decoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the decoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to decode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + A pointer to the beginning of the input buffer. + The length of the input buffer. + A pointer to the beginning of the output buffer. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the decoder. + + + Resets the state of the decoder. + + + + + Incrementally encodes content using the quoted-printable encoding. + + + Quoted-Printable is an encoding often used in MIME to encode textual content + outside of the ASCII range in order to ensure that the text remains intact + when sent via 7bit transports such as SMTP. + + + + + Initialize a new instance of the class. + + + Creates a new quoted-printable encoder. + + The maximum number of octets allowed per line (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current encoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the encoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to encode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Encode the specified input into the output buffer. + + + Encodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Encode the specified input into the output buffer, flushing any internal buffer state as well. + + + Encodes the specified input into the output buffer, flusing any internal state as well. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the encoder. + + + Resets the state of the encoder. + + + + + Incrementally decodes content encoded with the Unix-to-Unix encoding. + + + The UUEncoding is an encoding that predates MIME and was used to encode + binary content such as images and other types of multi-media to ensure + that the data remained intact when sent via 7bit transports such as SMTP. + These days, the UUEncoding has largely been deprecated in favour of + the base64 encoding, however, some older mail clients still use it. + + + + + Initialize a new instance of the class. + + + Creates a new Unix-to-Unix decoder. + + + If true, decoding begins immediately rather than after finding a begin-line. + + + + + Initialize a new instance of the class. + + + Creates a new Unix-to-Unix decoder. + + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current decoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the decoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to decode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + A pointer to the beginning of the input buffer. + The length of the input buffer. + A pointer to the beginning of the output buffer. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the decoder. + + + Resets the state of the decoder. + + + + + Incrementally encodes content using the Unix-to-Unix encoding. + + + The UUEncoding is an encoding that predates MIME and was used to encode + binary content such as images and other types of multi-media to ensure + that the data remained intact when sent via 7bit transports such as SMTP. + These days, the UUEncoding has largely been deprecated in favour of + the base64 encoding, however, some older mail clients still use it. + + + + + Initialize a new instance of the class. + + + Creates a new Unix-to-Unix encoder. + + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current encoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the encoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to encode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Encode the specified input into the output buffer. + + + Encodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Encode the specified input into the output buffer, flushing any internal buffer state as well. + + + Encodes the specified input into the output buffer, flusing any internal state as well. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the encoder. + + + Resets the state of the encoder. + + + + + Incrementally decodes content encoded with the yEnc encoding. + + + The yEncoding is an encoding that is most commonly used with Usenet and + is a binary encoding that includes a 32-bit cyclic redundancy check. + For more information, see www.yenc.org. + + + + + Initialize a new instance of the class. + + + Creates a new yEnc decoder. + + + If true, decoding begins immediately rather than after finding an =ybegin line. + + + + + Initialize a new instance of the class. + + + Creates a new yEnc decoder. + + + + + Get the checksum. + + + Gets the checksum. + + The checksum. + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current decoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the decoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to decode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + A pointer to the beginning of the input buffer. + The length of the input buffer. + A pointer to the beginning of the output buffer. + + + + Decode the specified input into the output buffer. + + + Decodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + decoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the decoder. + + + Resets the state of the decoder. + + + + + Incrementally encodes content using the yEnc encoding. + + + The yEncoding is an encoding that is most commonly used with Usenet and + is a binary encoding that includes a 32-bit cyclic redundancy check. + For more information, see www.yenc.org. + + + + + Initialize a new instance of the class. + + + Creates a new yEnc encoder. + + The line length to use. + + is not within the range of 60 to 998. + + + + + Get the checksum. + + + Gets the checksum. + + The checksum. + + + + Clone the with its current state. + + + Creates a new with exactly the same state as the current encoder. + + A new with identical state. + + + + Get the encoding. + + + Gets the encoding that the encoder supports. + + The encoding. + + + + Estimate the length of the output. + + + Estimates the number of bytes needed to encode the specified number of input bytes. + + The estimated output length. + The input length. + + + + Encode the specified input into the output buffer. + + + Encodes the specified input into the output buffer. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Encode the specified input into the output buffer, flushing any internal buffer state as well. + + + Encodes the specified input into the output buffer, flushing any internal state as well. + The output buffer should be large enough to hold all of the + encoded input. For estimating the size needed for the output buffer, + see . + + The number of bytes written to the output buffer. + The input buffer. + The starting index of the input buffer. + The length of the input buffer. + The output buffer. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + is not large enough to contain the encoded content. + Use the method to properly determine the + necessary length of the byte array. + + + + + Reset the encoder. + + + Resets the state of the encoder. + + + + + An experimental replacement for . + + + An experimental replacement for . + + + + + Initialize a new instance of the class. + + + Creates a new that will parse the specified stream. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The stream to parse. + The format of the stream. + true if the stream is persistent; otherwise false. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new that will parse the specified stream. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The stream to parse. + true if the stream is persistent; otherwise false. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new that will parse the specified stream. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The parser options. + The stream to parse. + true if the stream is persistent; otherwise false. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new that will parse the specified stream. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The parser options. + The stream to parse. + The format of the stream. + true if the stream is persistent; otherwise false. + + is null. + -or- + is null. + + + + + Gets the most recent mbox marker offset. + + + Gets the most recent mbox marker offset. + + The mbox marker offset. + + + + Gets the most recent mbox marker. + + + Gets the most recent mbox marker. + + The mbox marker. + + + + Set the stream to parse. + + + Sets the stream to parse. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The stream to parse. + The format of the stream. + true if the stream is persistent; otherwise false. + + is null. + + + + + Set the stream to parse. + + + Sets the stream to parse. + + The stream to parse. + The format of the stream. + + is null. + + + + + Set the stream to parse. + + + Sets the stream to parse. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The stream to parse. + true if the stream is persistent; otherwise false. + + is null. + + + + + Called when an Mbox marker is encountered in the stream. + + + When the stream is specified to be in format, this method will be called whenever the parser encounters an Mbox marker. + It is not necessary to override this method unless it is desirable to track the offsets of mbox markers within a stream or to extract the mbox marker itself. + + The buffer containing the mbox marker. + The index denoting the starting position of the mbox marker within the buffer. + The length of the mbox marker within the buffer, in bytes. + The offset into the stream where the mbox marker begins. + The line number where the mbox marker exists within the stream. + The cancellation token. + + + + Called when the beginning of a list of headers is encountered in the stream. + + + Called when the beginning of a list of headers is encountered in the stream. + This method is always paired with a corresponding call to when the end of the list of headers are found. + + The offset into the stream where the headers begin. + The line number where the list of headers begin. + The cancellation token. + + + + Called when a message or MIME part header is read from the stream. + + + This method will be called whenever a message or MIME part header is encountered within the stream. + + The header that was read from the stream. + The line number where the header exists within the stream. + The cancellation token. + + + + Called when the end of a list of headers is encountered in the stream. + + + Called when the end of a list of headers is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the headers began. + The line number where the list of headers began. + The offset into the stream where the list of headers ended. + The line number headers where the list of headers ended. + The cancellation token. + + + + Called when the beginning of a message is encountered in the stream. + + + Called when the beginning of a message is encountered in the stream. + This method is always paired with a corresponding call to when the end of the message is found. + + The offset into the stream where the message begins. + The line number where the message begins. + The cancellation token. + + + + Called when the end of a message is encountered in the stream. + + + Called when the end of a message is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the message began. + The line number where the message began. + The offset into the stream where the message headers ended and the content began. + The offset into the stream where the message ended. + The length of the message as measured in lines. + The cancellation token. + + + + Called when the beginning of a MIME part is encountered in the stream. + + + Called when the beginning of a MIME part is encountered in the stream. + This method is always paired with a corresponding call to when the end of the MIME part is found. + + The parsed Content-Type header of the MIME part. + The offset into the stream where the MIME part begins. + The line number where the MIME part begins. + The cancellation token. + + + + Called when the beginning of a MIME part's content is encountered in the stream. + + + Called when the beginning of a MIME part's content is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the MIME part content began. + The line number where the MIME part content began. + The cancellation token. + + + + Called when MIME part content is read from the stream. + + + Called when MIME part content is read from the stream. + + A buffer containing the MIME part content. + The index denoting the starting position of the content within the buffer. + The length of the content within the buffer, in bytes. + The cancellation token. + + + + Called when the end of a MIME part's content is encountered in the stream. + + + Called when the end of a MIME part's content is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the MIME part content began. + The line number where the MIME part content began. + The offset into the stream where the MIME part content ended. + The length of the MIME part content as measured in lines. + The new-line format of the content, if known. + The cancellation token. + + + + Called when the end of a MIME part is encountered in the stream. + + + Called when the end of a MIME part is encountered in the stream. + This method is always paired with a corresponding call to . + + The parsed Content-Type header of the MIME part. + The offset into the stream where the MIME part began. + The line number where the MIME part began. + The offset into the stream where the MIME part headers ended and the content began. + The offset into the stream where the MIME part ends. + The length of the MIME part as measured in lines. + The cancellation token. + + + + Called when the beginning of a message part is encountered in the stream. + + + Called when the beginning of a message part is encountered in the stream. + This method is always paired with a corresponding call to when the end of the message part is found. + + The parsed Content-Type header of the MIME part. + The offset into the stream where the message part begins. + The line number where the message part begins. + The cancellation token. + + + + Called when the end of a message part is encountered in the stream. + + + Called when the end of a message part is encountered in the stream. + This method is always paired with a corresponding call to . + + The parsed Content-Type header of the MIME part. + The offset into the stream where the message part began. + The line number where the message part began. + The offset into the stream where the MIME part headers ended and the content began. + The offset into the stream where the MIME part ends. + The length of the MIME part as measured in lines. + The cancellation token. + + + + Called when the beginning of a multipart is encountered in the stream. + + + Called when the beginning of a multipart is encountered in the stream. + This method is always paired with a corresponding call to when the end of the multipart is found. + + The parsed Content-Type header of the multipart. + The offset into the stream where the multipart begins. + The line number where the multipart begins. + The cancellation token. + + + + Called when a multipart boundary is encountered in the stream. + + + Called when a multipart boundary is encountered in the stream. + + The multipart boundary string. + The offset into the stream where the boundary marker began. + The offset into the stream where the boundary marker ended. + The line number where the boundary marker was found in the stream. + The cancellation token. + + + + Called when a multipart end boundary is encountered in the stream. + + + Called when a multipart end boundary is encountered in the stream. + + The multipart boundary string. + The offset into the stream where the boundary marker began. + The offset into the stream where the boundary marker ended. + The line number where the boundary marker was found in the stream. + The cancellation token. + + + + Called when the beginning of the preamble of a multipart is encountered in the stream. + + + Called when the beginning of the preamble of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the preamble began. + The line number where the preamble began. + The cancellation token. + + + + Called when multipart preamble text is read from the stream. + + + Called when multipart preamble text is read from the stream. + + A buffer containing the multipart preamble text. + The index denoting the starting position of the content within the buffer. + The length of the content within the buffer, in bytes. + The cancellation token. + + + + Called when the end of the preamble of a multipart is encountered in the stream. + + + Called when the end of the preamble of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the multipart preamble began. + The line number where the multipart preamble began. + The offset into the stream where the multipart preamble ended. + The length of the multipart preamble as measured in lines. + The cancellation token. + + + + Called when the beginning of the epilogue of a multipart is encountered in the stream. + + + Called when the beginning of the epilogue of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the epilogue began. + The line number where the epilogue began. + The cancellation token. + + + + Called when multipart epilogue text is read from the stream. + + + Called when multipart epilogue text is read from the stream. + + A buffer containing the multipart epilogue text. + The index denoting the starting position of the content within the buffer. + The length of the content within the buffer, in bytes. + The cancellation token. + + + + Called when the end of the epilogue of a multipart is encountered in the stream. + + + Called when the end of the epilogue of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + The offset into the stream where the multipart epilogue began. + The line number where the multipart epilogue began. + The offset into the stream where the multipart epilogue ended. + The length of the multipart epilogue as measured in lines. + The cancellation token. + + + + Called when the end of a multipart is encountered in the stream. + + + Called when the end of a multipart is encountered in the stream. + This method is always paired with a corresponding call to . + + The parsed Content-Type header of the multipart. + The offset into the stream where the multipart began. + The line number where the multipart began. + The offset into the stream where the multipart headers ended and the content began. + The offset into the stream where the multipart ends. + The length of the multipart as measured in lines. + The cancellation token. + + + + Parse a list of headers from the stream. + + + Parses a list of headers from the stream. + + The parsed list of headers. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Asynchronously parse a list of headers from the stream. + + + Asynchronously parses a list of headers from the stream. + + The parsed list of headers. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Parse an entity from the stream. + + + Parses an entity from the stream. + + The parsed entity. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously parse an entity from the stream. + + + Asynchronously parses an entity from the stream. + + The parsed entity. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Parse a message from the stream. + + + Parses a message from the stream. + + The parsed message. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the message. + + + An I/O error occurred. + + + + + Asynchronously parse a message from the stream. + + + Asynchronously parses a message from the stream. + + The parsed message. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the message. + + + An I/O error occurred. + + + + + A New-Line format. + + + There are two commonly used line-endings used by modern Operating Systems. + Unix-based systems such as Linux and Mac OS use a single character ('\n' aka LF) + to represent the end of line where-as Windows (or DOS) uses a sequence of two + characters ("\r\n" aka CRLF). Most text-based network protocols such as SMTP, + POP3, and IMAP use the CRLF sequence as well. + + + + + The Unix New-Line format ("\n"). + + + + + The DOS New-Line format ("\r\n"). + + + + + A mixed New-Line format where some lines use Unix-based line endings and + other lines use DOS-based line endings. + + + + + Format options for serializing various MimeKit objects. + + + Represents the available options for formatting MIME messages + and entities when writing them to a stream. + + + + + The default formatting options. + + + If a custom is not passed to methods such as + , + the default options will be used. + + + + + Get or set the maximum line length used by the encoders. The encoders + use this value to determine where to place line breaks. + + + Specifies the maximum line length to use when line-wrapping headers. + + The maximum line length. + + is out of range. It must be between 60 and 998. + + + cannot be changed. + + + + + Get or set the new-line format. + + + Specifies the new-line encoding to use when writing the message + or entity to a stream. + + The new-line format. + + is not a valid . + + + cannot be changed. + + + + + Get or set whether the formatter should ensure that messages end with a new-line sequence. + + + By default, when writing a to a stream, the serializer attempts to + maintain byte-for-byte compatibility with the original stream that the message was parsed from. + This means that if the ogirinal message stream did not end with a new-line sequence, then the + output of writing the message back to a stream will also not end with a new-line sequence. + To override this behavior, you can set this property to true in order to ensure + that writing the message back to a stream will always end with a new-line sequence. + + true in order to ensure that the message will end with a new-line sequence; otherwise, false. + + cannot be changed. + + + + + Get the message headers that should be hidden. + + + Specifies the set of headers that should be removed when + writing a to a stream. + This is primarily meant for the purposes of removing Bcc + and Resent-Bcc headers when sending via a transport such as + SMTP. + + The message headers. + + + + Get or set whether the new "Internationalized Email" formatting standards should be used. + + + The new "Internationalized Email" format is defined by + rfc6530 and + rfc6532. + This feature should only be used when formatting messages meant to be sent via + SMTP using the SMTPUTF8 extension (rfc6531) + or when appending messages to an IMAP folder via UTF8 APPEND + (rfc6855). + + true if the new internationalized formatting should be used; otherwise, false. + + cannot be changed. + + + + + Get or set whether the formatter should allow mixed charsets in the headers. + + + When this option is enabled, the MIME formatter will try to use us-ascii and/or + iso-8859-1 to encode headers when appropriate rather than being forced to use the + specified charset for all encoded-word tokens in order to maximize readability. + Unfortunately, mail clients like Outlook and Thunderbird do not treat + encoded-word tokens individually and assume that all tokens are encoded using the + charset declared in the first encoded-word token despite the specification + explicitly stating that each encoded-word token should be treated independently. + The Thunderbird bug can be tracked at + + https://bugzilla.mozilla.org/show_bug.cgi?id=317263. + + true if the formatter should be allowed to use us-ascii and/or iso-8859-1 when encoding headers; otherwise, false. + + + + Get or set the method to use for encoding Content-Type and Content-Disposition parameter values. + + + The method to use for encoding Content-Type and Content-Disposition parameter + values when the is set to + . + The MIME specifications specify that the proper method for encoding Content-Type + and Content-Disposition parameter values is the method described in + rfc2231. However, it is common for + some older email clients to improperly encode using the method described in + rfc2047 instead. + + The parameter encoding method that will be used. + + is not a valid value. + + + + + Get or set whether Content-Type and Content-Disposition parameter values should always be quoted even when they don't need to be. + + + Gets or sets whether Content-Type and Content-Disposition parameter values should always be quoted even when they don't need to be. + Technically, Content-Type and Content-Disposition parameter values only require quoting when they contain characters + that have special meaning to a MIME parser. However, for compatibility with email processing solutions that do not properly + adhere to the MIME specifications, this property can be used to force MimeKit to quote parameter values that would normally + not require quoting. + + true if Content-Type and Content-Disposition parameters should always be quoted; otherwise, false. + + + + Initialize a new instance of the class. + + + Creates a new set of formatting options for use with methods such as + . + + + + + Clone an instance of . + + + Clones the formatting options. + + An exact copy of the . + + + + An address group, as specified by rfc0822. + + + Group addresses are rarely used anymore. Typically, if you see a group address, + it will be of the form: "undisclosed-recipients: ;". + + + + + Initialize a new instance of the class. + + + Creates a new with the specified name and list of addresses. The + specified text encoding is used when encoding the name according to the rules of rfc2047. + + The character encoding to be used for encoding the name. + The name of the group. + A list of addresses. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new with the specified name and list of addresses. + + The name of the group. + A list of addresses. + + + + Initialize a new instance of the class. + + + Creates a new with the specified name. The specified + text encoding is used when encoding the name according to the rules of rfc2047. + + The character encoding to be used for encoding the name. + The name of the group. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new with the specified name. + + The name of the group. + + + + Clone the group address. + + + Clones the group address. + + The cloned group address. + + + + Get the members of the group. + + + Represents the member addresses of the group. If the group address properly conforms + to the internet standards, every group member should be of the + variety. When handling group addresses constructed by third-party software, it is possible + for groups to contain members of the variety. + When constructing new messages, it is recommended that address groups not contain + anything other than members in order to comply with internet + standards. + + The list of members. + + + + Return a string representation of the , + optionally encoding it for transport. + + + Returns a string containing the formatted group of addresses. If the + parameter is true, then the name of the group and all member addresses will be encoded + according to the rules defined in rfc2047, otherwise the names will not be encoded at all and + will therefor only be suitable for display purposes. + + A string representing the . + The formatting options. + If set to true, the will be encoded. + + is null. + + + + + Determine whether the specified is equal to the current . + + + Compares two group addresses to determine if they are identical or not. + + The to compare with the current . + true if the specified is equal to the current + ; otherwise, false. + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed group address. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed group address. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The starting index of the input buffer. + The parsed group address. + + is null. + -or- + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The parsed group address. + + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The parsed group address. + + is null. + -or- + is null. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The input buffer. + The parsed group address. + + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The text. + The parsed group address. + + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The text. + The parsed group address. + + is null. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + The parsed . + The parser options to use. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + The parsed . + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + + is null. + + + and do not specify + a valid range in the byte array. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + The parsed . + The parser options to use. + The input buffer. + The starting index of the input buffer. + + is null. + -or- + is null. + + + is out of range. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + The parsed . + The input buffer. + The starting index of the input buffer. + + is null. + + + is out of range. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + The parsed . + The parser options to use. + The input buffer. + + is null. + -or- + is null. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + The parsed . + The input buffer. + + is null. + + + could not be parsed. + + + + + Parse the given text into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + The parsed . + The parser options to use. + The text. + + is null. + -or- + is null. + + + could not be parsed. + + + + + Parse the given text into a new instance. + + + Parses a single . If the address is not a group address or + there is more than a single group address, then parsing will fail. + + The parsed . + The text. + + is null. + + + could not be parsed. + + + + + A class representing a Message or MIME header. + + + Represents a single header field and value pair. + + + + + Initialize a new instance of the class. + + + Creates a new message or entity header for the specified field and + value pair. The encoding is used to determine which charset to use + when encoding the value according to the rules of rfc2047. + + The character encoding that should be used to + encode the header value. + The header identifier. + The value of the header. + + is null. + -or- + is null. + + + is not a valid . + + + + + Initialize a new instance of the class. + + + Creates a new message or entity header for the specified field and + value pair. The encoding is used to determine which charset to use + when encoding the value according to the rules of rfc2047. + + The charset that should be used to encode the + header value. + The header identifier. + The value of the header. + + is null. + -or- + is null. + + + is not a valid . + + + is not supported. + + + + + Initialize a new instance of the class. + + + Creates a new message or entity header for the specified field and + value pair with the UTF-8 encoding. + + The header identifier. + The value of the header. + + is null. + + + is not a valid . + + + + + Initialize a new instance of the class. + + + Creates a new message or entity header for the specified field and + value pair. The encoding is used to determine which charset to use + when encoding the value according to the rules of rfc2047. + + The character encoding that should be used + to encode the header value. + The name of the header field. + The value of the header. + + is null. + -or- + is null. + -or- + is null. + + + The contains illegal characters. + + + + + Initialize a new instance of the class. + + + Creates a new message or entity header for the specified field and + value pair. The encoding is used to determine which charset to use + when encoding the value according to the rules of rfc2047. + + The charset that should be used to encode the + header value. + The name of the header field. + The value of the header. + + is null. + -or- + is null. + -or- + is null. + + + The contains illegal characters. + + + is not supported. + + + + + Initialize a new instance of the class. + + + Creates a new message or entity header for the specified field and + value pair with the UTF-8 encoding. + + The name of the header field. + The value of the header. + + is null. + -or- + is null. + + + The contains illegal characters. + + + + + Initialize a new instance of the class. + + + Creates a new message or entity header with the specified values. + This constructor is used by . + + The parser options used. + The id of the header. + The name of the header field. + The raw header field. + The raw value of the header. + + + + Initialize a new instance of the class. + + + Creates a new message or entity header with the specified raw values. + This constructor is used by the + TryParse methods. + + The parser options used. + The raw header field. + The length of the field name (not including trailing whitespace). + The raw value of the header. + true if the header field is invalid; otherwise, false. + + + + Initialize a new instance of the class. + + + Creates a new message or entity header with the specified raw values. + This constructor is used by the + TryParse methods. + + The parser options used. + The raw header field. + The raw value of the header. + true if the header field is invalid; otherwise, false. + + + + Initialize a new instance of the class. + + + Creates a new message or entity header with the specified raw values. + This constructor is used by and + when serializing new values for headers. + + The parser options used. + The id of the header. + The raw header field. + The raw value of the header. + + + + Clone the header. + + + Clones the header, copying the current RawValue. + + A copy of the header with its current state. + + + + Get the stream offset of the beginning of the header. + + + If the offset is set, it refers to the byte offset where it + was found in the stream it was parsed from. + + The stream offset. + + + + Get the name of the header field. + + + Represents the field name of the header. + + The name of the header field. + + + + Get the header identifier. + + + This property is mainly used for switch-statements for performance reasons. + + The header identifier. + + + + Get the raw field name of the header. + + + Contains the raw field name of the header. + + The raw field name of the header. + + + + Get the raw value of the header. + + + Contains the raw value of the header, before any decoding or charset conversion. + + The raw value of the header. + + + + Get or sets the header value. + + + Represents the decoded header value and is suitable for displaying to the user. + + The header value. + + is null. + + + + + Get the header value using the specified character encoding. + + + If the raw header value does not properly encode non-ASCII text, the decoder + will fall back to a default charset encoding. Sometimes, however, this + default charset fallback is wrong and the mail client may wish to override + that default charset on a per-header basis. + By using this method, the client is able to override the fallback charset + on a per-header basis. + + The value. + The character encoding to use as a fallback. + + + + Get the header value using the specified charset. + + + If the raw header value does not properly encode non-ASCII text, the decoder + will fall back to a default charset encoding. Sometimes, however, this + default charset fallback is wrong and the mail client may wish to override + that default charset on a per-header basis. + By using this method, the client is able to override the fallback charset + on a per-header basis. + + The value. + The charset to use as a fallback. + + + + Format the raw value of the header to conform with the specified formatting options. + + + This method is called by the SetValue + methods. + This method should encode unicode characters according to the rules of rfc2047 (when + is false) as well as properly folding the + value to conform with rfc5322. + + The formatting options. + The character encoding to be used. + The decoded (and unfolded) header value. + A byte array containing the raw header value that should be written. + + + + Ses the header value using the specified formatting options and character encoding. + + + When a particular charset is desired for encoding the header value + according to the rules of rfc2047, this method should be used + instead of the setter. + + The formatting options. + A character encoding. + The header value. + + is null. + -or- + is null. + -or- + is null. + + + + + Set the header value using the specified character encoding. + + + When a particular charset is desired for encoding the header value + according to the rules of rfc2047, this method should be used + instead of the setter. + + A character encoding. + The header value. + + is null. + -or- + is null. + + + + + Set the header value using the specified formatting options and charset. + + + When a particular charset is desired for encoding the header value + according to the rules of rfc2047, this method should be used + instead of the setter. + + The formatting options. + A charset encoding. + The header value. + + is null. + -or- + is null. + -or- + is null. + + + is not supported. + + + + + Set the header value using the specified charset. + + + When a particular charset is desired for encoding the header value + according to the rules of rfc2047, this method should be used + instead of the setter. + + A charset encoding. + The header value. + + is null. + -or- + is null. + + + is not supported. + + + + + Set the raw header value. + + + Sets the raw header value. + This method can be used to override default encoding and folding behavior + for a particular header. + + The raw header value. + + is null. + + + does not end with a new-line character. + + + + + Return a string representation of the header. + + + Formats the header field and value in a way that is suitable for display. + + A string representing the . + + + + Unfold the specified header value. + + + Unfolds the header value so that it becomes suitable for display. + Since is already unfolded, this method is really + only needed when working with raw header strings. + + The unfolded header value. + The header text. + + + + Try to parse the given input buffer into a new instance. + + + Parses a header from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + true, if the header was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed header. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a header from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + true, if the header was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed header. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a header from the supplied buffer starting at the specified index. + + true, if the header was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The starting index of the input buffer. + The parsed header. + + is null. + -or- + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a header from the supplied buffer starting at the specified index. + + true, if the header was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The parsed header. + + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a header from the specified buffer. + + true, if the header was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The parsed header. + + is null. + -or- + is null. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a header from the specified buffer. + + true, if the header was successfully parsed, false otherwise. + The input buffer. + The parsed header. + + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a header from the specified text. + + true, if the header was successfully parsed, false otherwise. + The parser options to use. + The text to parse. + The parsed header. + + is null. + -or- + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a header from the specified text. + + true, if the header was successfully parsed, false otherwise. + The text to parse. + The parsed header. + + is null. + + + + + An enumeration of common header fields. + + + Comparing enum values is not only faster, but less error prone than + comparing strings. + + + + + The Accept-Language header field. + + + + + The Ad-Hoc header field. + + + + + The Alternate-Recipient header field. + + + + + The Apparently-To header field. + + + + + The Approved header field. + + + + + The ARC-Authentication-Results header field. + + + + + The ARC-Message-Signature header field. + + + + + The ARC-Seal header field. + + + + + The Archive header field. + + + + + The Archived-At header field. + + + + + The Article header field. + + + + + The Authentication-Results header field. + + + + + The Autocrypt header field. + + + + + The Autocrypt-Gossip header field. + + + + + The Autocrypt-Setup-Message header field. + + + + + The Autoforwarded header field. + + + + + The Auto-Submitted header field. + + + + + The Autosubmitted header field. + + + + + The Base header field. + + + + + The Bcc header field. + + + + + The Body header field. + + + + + The Bytes header field. + + + + + The Cc header field. + + + + + The Comments header field. + + + + + The Content-Alternative header field. + + + + + The Content-Base header field. + + + + + The Content-Class header field. + + + + + The Content-Description header field. + + + + + The Content-Disposition header field. + + + + + The Content-Duration header field. + + + + + The Content-Features header field. + + + + + The Content-Id header field. + + + + + The Content-Identifier header field. + + + + + The Content-Language header field. + + + + + The Content-Length header field. + + + + + The Content-Location header field. + + + + + The Content-Md5 header field. + + + + + The Content-Return header field. + + + + + The Content-Transfer-Encoding header field. + + + + + The Content-Translation-Type header field. + + + + + The Content-Type header field. + + + + + The Control header field. + + + + + The Conversion header field. + + + + + The Conversion-With-Loss header field. + + + + + The Date header field. + + + + + The Date-Received header field. + + + + + The Deferred-Delivery header field. + + + + + The Delivery-Date header field. + + + + + The Disclose-Recipients header field. + + + + + The Disposition-Notification-Options header field. + + + + + The Disposition-Notification-To header field. + + + + + The Distribution header field. + + + + + The DKIM-Signature header field. + + + + + The DomainKey-Signature header field. + + + + + The Encoding header field. + + + + + The Encrypted header field. + + + + + The Expires header field. + + + + + The Expiry-Date header field. + + + + + The Followup-To header field. + + + + + The From header field. + + + + + The Generate-Delivery-Report header field. + + + + + The Importance header field. + + + + + The Injection-Date header field. + + + + + The Injection-Info header field. + + + + + The In-Reply-To header field. + + + + + The Keywords header field. + + + + + The Language header. + + + + + The Latest-Delivery-Time header. + + + + + The Lines header field. + + + + + The List-Archive header field. + + + + + The List-Help header field. + + + + + The List-Id header field. + + + + + The List-Owner header field. + + + + + The List-Post header field. + + + + + The List-Subscribe header field. + + + + + The List-Unsubscribe header field. + + + + + The List-Unsubscribe-Post header field. + + + + + The Message-Id header field. + + + + + The MIME-Version header field. + + + + + The Newsgroups header field. + + + + + The Nntp-Posting-Host header field. + + + + + The Organization header field. + + + + + The Original-From header field. + + + + + The Original-Message-Id header field. + + + + + The Original-Recipient header field. + + + + + The Original-Return-Address header field. + + + + + The Original-Subject header field. + + + + + The Path header field. + + + + + The Precedence header field. + + + + + The Prevent-NonDelivery-Report header field. + + + + + The Priority header field. + + + + + The Received header field. + + + + + The Received-SPF header field. + + + + + The References header field. + + + + + The Relay-Version header field. + + + + + The Reply-By header field. + + + + + The Reply-To header field. + + + + + The Require-Recipient-Valid-Since header field. + + + + + The Resent-Bcc header field. + + + + + The Resent-Cc header field. + + + + + The Resent-Date header field. + + + + + The Resent-From header field. + + + + + The Resent-Message-Id header field. + + + + + The Resent-Reply-To header field. + + + + + The Resent-Sender header field. + + + + + The Resent-To header field. + + + + + The Return-Path header field. + + + + + The Return-Receipt-To header field. + + + + + The See-Also header field. + + + + + The Sender header field. + + + + + The Sensitivity header field. + + + + + The Solicitation header field. + + + + + The Status header field. + + + + + The Subject header field. + + + + + The Summary header field. + + + + + The Supersedes header field. + + + + + The TLS-Required header field. + + + + + The To header field. + + + + + The User-Agent header field. + + + + + The X400-Content-Identifier header field. + + + + + The X400-Content-Return header field. + + + + + The X400-Content-Type header field. + + + + + The X400-MTS-Identifier header field. + + + + + The X400-Originator header field. + + + + + The X400-Received header field. + + + + + The X400-Recipients header field. + + + + + The X400-Trace header field. + + + + + The X-Mailer header field. + + + + + The X-MSMail-Priority header field. + + + + + The X-Priority header field. + + + + + The X-Status header field. + + + + + An unknown header field. + + + + + extension methods. + + + extension methods. + + + + + Converts the enum value into the equivalent header field name. + + + Converts the enum value into the equivalent header field name. + + The header name. + The enum value. + + + + A list of s. + + + Represents a list of headers as found in a + or . + + + + + Initialize a new instance of the class. + + + Creates a new empty header list. + + + + + Add a header with the specified field and value. + + + Adds a new header for the specified field and value pair. + + The header identifier. + The header value. + + is null. + + + is not a valid . + + + + + Add a header with the specified field and value. + + + Adds a new header for the specified field and value pair. + + The name of the header field. + The header value. + + is null. + -or- + is null. + + + The contains illegal characters. + + + + + Add a header with the specified field and value. + + + Adds a new header for the specified field and value pair. + + The header identifier. + The character encoding to use for the value. + The header value. + + is null. + -or- + is null. + + + is not a valid . + + + + + Add a header with the specified field and value. + + + Adds a new header for the specified field and value pair. + + The name of the header field. + The character encoding to use for the value. + The header value. + + is null. + -or- + is null. + -or- + is null. + + + The contains illegal characters. + + + + + Check if the contains a header with the specified field name. + + + Determines whether or not the header list contains the specified header. + + true if the requested header exists; + otherwise false. + The header identifier. + + is not a valid . + + + + + Check if the contains a header with the specified field name. + + + Determines whether or not the header list contains the specified header. + + true if the requested header exists; + otherwise false. + The name of the header field. + + is null. + + + + + Get the index of the requested header, if it exists. + + + Finds the first index of the specified header, if it exists. + + The index of the requested header; otherwise -1. + The header id. + + is not a valid . + + + + + Get the index of the requested header, if it exists. + + + Finds the first index of the specified header, if it exists. + + The index of the requested header; otherwise -1. + The name of the header field. + + is null. + + + + + Insert a header with the specified field and value at the given index. + + + Inserts the header at the specified index in the list. + + The index to insert the header. + The header identifier. + The header value. + + is null. + + + is not a valid . + -or- + is out of range. + + + + + Insert a header with the specified field and value at the given index. + + + Inserts the header at the specified index in the list. + + The index to insert the header. + The name of the header field. + The header value. + + is null. + -or- + is null. + + + The contains illegal characters. + + + is out of range. + + + + + Insert a header with the specified field and value at the given index. + + + Inserts the header at the specified index in the list. + + The index to insert the header. + The header identifier. + The character encoding to use for the value. + The header value. + + is null. + -or- + is null. + + + is not a valid . + -or- + is out of range. + + + + + Insert a header with the specified field and value at the given index. + + + Inserts the header at the specified index in the list. + + The index to insert the header. + The name of the header field. + The character encoding to use for the value. + The header value. + + is null. + -or- + is null. + -or- + is null. + + + The contains illegal characters. + + + is out of range. + + + + + Get the last index of the requested header, if it exists. + + + Finds the last index of the specified header, if it exists. + + The last index of the requested header; otherwise -1. + The header id. + + is not a valid . + + + + + Get the last index of the requested header, if it exists. + + + Finds the last index of the specified header, if it exists. + + The last index of the requested header; otherwise -1. + The name of the header field. + + is null. + + + + + Remove the first occurrence of the specified header field. + + + Removes the first occurrence of the specified header field, if any exist. + + true if the first occurrence of the specified + header was removed; otherwise false. + The header identifier. + + is is not a valid . + + + + + Remove the first occurrence of the specified header field. + + + Removes the first occurrence of the specified header field, if any exist. + + true if the first occurrence of the specified + header was removed; otherwise false. + The name of the header field. + + is null. + + + + + Remove all of the headers matching the specified field name. + + + Removes all of the headers matching the specified field name. + + The header identifier. + + is not a valid . + + + + + Remove all of the headers matching the specified field name. + + + Removes all of the headers matching the specified field name. + + The name of the header field. + + is null. + + + + + Replace all headers with identical field names with the single specified header. + + + Replaces all headers with identical field names with the single specified header. + If no headers with the specified field name exist, it is simply added. + + The header identifier. + The character encoding to use for the value. + The header value. + + is null. + -or- + is null. + + + is not a valid . + + + + + Replace all headers with identical field names with the single specified header. + + + Replaces all headers with identical field names with the single specified header. + If no headers with the specified field name exist, it is simply added. + + The header identifier. + The header value. + + is null. + + + is not a valid . + + + + + Replace all headers with identical field names with the single specified header. + + + Replaces all headers with identical field names with the single specified header. + If no headers with the specified field name exist, it is simply added. + + The name of the header field. + The character encoding to use for the value. + The header value. + + is null. + -or- + is null. + -or- + is null. + + + + + Replace all headers with identical field names with the single specified header. + + + Replaces all headers with identical field names with the single specified header. + If no headers with the specified field name exist, it is simply added. + + The name of the header field. + The header value. + + is null. + -or- + is null. + + + The contains illegal characters. + + + + + Get or set the value of the first occurrence of a header + with the specified field name. + + + Gets or sets the value of the first occurrence of a header + with the specified field name. + + The value of the first occurrence of the specified header if it exists; otherwise null. + The header identifier. + + is null. + + + + + Get or set the value of the first occurrence of a header + with the specified field name. + + + Gets or sets the value of the first occurrence of a header + with the specified field name. + + The value of the first occurrence of the specified header if it exists; otherwise null. + The name of the header field. + + is null. + -or- + is null. + + + + + Write the to the specified output stream. + + + Writes all of the headers to the output stream. + + The formatting options. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Writes all of the headers to the output stream. + + A task that represents the asynchronous write operation. + The formatting options. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the to the specified output stream. + + + Writes all of the headers to the output stream. + + The output stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Writes all of the headers to the output stream. + + A task that represents the asynchronous write operation. + The output stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Get the number of headers in the list. + + + Gets the number of headers in the list. + + The number of headers. + + + + Get whether or not the header list is read only. + + + A is never read-only. + + true if this instance is read only; otherwise, false. + + + + Add the specified header. + + + Adds the specified header to the end of the header list. + + The header to add. + + is null. + + + + + Clear the header list. + + + Removes all of the headers from the list. + + + + + Check if the contains the specified header. + + + Determines whether or not the header list contains the specified header. + + true if the specified header is contained; + otherwise, false. + The header. + + is null. + + + + + Copy all of the headers in the to the specified array. + + + Copies all of the headers within the into the array, + starting at the specified array index. + + The array to copy the headers to. + The index into the array. + + is null. + + + is out of range. + + + + + Remove the specified header. + + + Removes the specified header from the list if it exists. + + true if the specified header was removed; + otherwise false. + The header. + + is null. + + + + + Replace all headers with identical field names with the single specified header. + + + Replaces all headers with identical field names with the single specified header. + If no headers with the specified field name exist, it is simply added. + + The header. + + is null. + + + + + Get the index of the requested header, if it exists. + + + Finds the index of the specified header, if it exists. + + The index of the requested header; otherwise -1. + The header. + + is null. + + + + + Insert the specified header at the given index. + + + Inserts the header at the specified index in the list. + + The index to insert the header. + The header. + + is null. + + + is out of range. + + + + + Remove the header at the specified index. + + + Removes the header at the specified index. + + The index. + + is out of range. + + + + + Get or set the at the specified index. + + + Gets or sets the at the specified index. + + The header at the specified index. + The index. + + is null. + + + is out of range. + + + + + Get an enumerator for the list of headers. + + + Gets an enumerator for the list of headers. + + The enumerator. + + + + Get an enumerator for the list of headers. + + + Gets an enumerator for the list of headers. + + The enumerator. + + + + Load a from the specified stream. + + + Loads a from the given stream, using the + specified . + + The parsed list of headers. + The parser options. + The stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified stream. + + + Loads a from the given stream, using the + specified . + + The parsed list of headers. + The parser options. + The stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Load a from the specified stream. + + + Loads a from the given stream, using the + default . + + The parsed list of headers. + The stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified stream. + + + Loads a from the given stream, using the + default . + + The parsed list of headers. + The stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified file. + + + Loads a from the file at the give file path, + using the specified . + + The parsed list of headers. + The parser options. + The name of the file to load. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified file. + + + Loads a from the file at the give file path, + using the specified . + + The parsed list of headers. + The parser options. + The name of the file to load. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Load a from the specified file. + + + Loads a from the file at the give file path, + using the default . + + The parsed list of headers. + The name of the file to load. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified file. + + + Loads a from the file at the give file path, + using the default . + + The parsed list of headers. + The name of the file to load. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Header list changed action. + + + Specifies the way that a was changed. + + + + + A header was added. + + + + + A header was changed. + + + + + A header was removed. + + + + + The header list was cleared. + + + + + A collection of groups. + + + A collection of groups used with + . + + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Gets the number of groups in the collection. + + + Gets the number of groups in the collection. + + The number of groups. + + + + Gets whether or not the header list collection is read only. + + + A is never read-only. + + true if this instance is read only; otherwise, false. + + + + Gets or sets the at the specified index. + + + Gets or sets the at the specified index. + + The group of headers at the specified index. + The index. + + is null. + + + is out of range. + + + + + Adds the group of headers to the collection. + + + Adds the group of headers to the collection. + + The group of headers. + + is null. + + + + + Clears the header list collection. + + + Removes all of the groups from the collection. + + + + + Checks if the collection contains the specified group of headers. + + + Determines whether or not the collection contains the specified group of headers. + + true if the specified group of headers is contained; + otherwise, false. + The group of headers. + + is null. + + + + + Copies all of the header groups in the to the specified array. + + + Copies all of the header groups within the into the array, + starting at the specified array index. + + The array to copy the headers to. + The index into the array. + + is null. + + + is out of range. + + + + + Removes the specified header group. + + + Removes the specified header group from the collection, if it exists. + + true if the specified header group was removed; + otherwise false. + The group of headers. + + is null. + + + + + Gets an enumerator for the groups of headers. + + + Gets an enumerator for the groups of headers. + + The enumerator. + + + + Gets an enumerator for the groups of headers. + + + Gets an enumerator for the groups of headers. + + The enumerator. + + + + An interface for a message delivery status MIME part. + + + A message delivery status MIME part is a machine readable notification denoting the + delivery status of a message and has a MIME-type of message/delivery-status. + For more information, see rfc3464. + + + + + + + + + Get the groups of delivery status fields. + + + Gets the groups of delivery status fields. The first + contains the per-message fields while each remaining contains + fields that pertain to particular recipients of the message. + For more information about these fields and their values, check out + rfc3464. + Section 2.2 defines + the per-message fields while + Section 2.3 defines + the per-recipient fields. + + + + + The fields. + + The has been disposed. + + + + + An interface for a message disposition notification MIME part. + + + A message disposition notification MIME part is a machine readable notification + denoting the disposition of a message once it has been successfully delivered + and has a MIME-type of message/disposition-notification. + + + + + + Get the disposition notification fields. + + + Gets the disposition notification fields. + + The disposition notification fields. + + The has been disposed. + + + + + An interface for a message feedback report MIME part. + + + A message/feedback-report MIME part is a machine readable feedback report. + + + + + + Get the feedback report fields. + + + Gets the feedback report fields. + + The feedback report fields. + + The has been disposed. + + + + + An interface for a MIME part containing a as its content. + + + Represents MIME entities such as those with a Content-Type of message/rfc822 or message/news. + + + + + Gets or sets the message content. + + + Gets or sets the message content. + + The message content. + + + + An interface for a MIME part containing a partial message as its content. + + + The "message/partial" MIME-type is used to split large messages into + multiple parts, typically to work around transport systems that have size + limitations (for example, some SMTP servers limit have a maximum message + size that they will accept). + + + + + Get the "id" parameter of the Content-Type header. + + + The "id" parameter is a unique identifier used to match the parts together. + + The identifier. + + + + Get the "number" parameter of the Content-Type header. + + + The "number" parameter is the sequential (1-based) index of the partial message fragment. + + The part number. + + + + Get the "total" parameter of the Content-Type header. + + + The "total" parameter is the total number of pieces that make up the complete message. + + The total number of parts. + + + + An interface for content stream encapsulation as used by . + + + Implemented by . + + + + + + + + Get the content encoding. + + + If the is not encoded, this value will be + . Otherwise, it will be + set to the raw content encoding of the stream. + + The encoding. + + + + Get the new-line format, if known. + + + This property is typically only set by the as it parses + the content of a and is only used as a hint when verifying + digital signatures. + + The new-line format, if known. + + + + Get the content stream. + + + Gets the content stream. + + The stream. + + + + Open the decoded content stream. + + + Provides a means of reading the decoded content without having to first write it to another + stream using . + + The decoded content stream. + + + + Decode the content stream into another stream. + + + If the content stream is encoded, this method will decode it into the output stream + using a suitable decoder based on the property, otherwise the + stream will be copied into the output stream as-is. + + + + + The output stream. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously decode the content stream into another stream. + + + If the content stream is encoded, this method will decode it into the output stream + using a suitable decoder based on the property, otherwise the + stream will be copied into the output stream as-is. + + + + + An awaitable task. + The output stream. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + An I/O error occurred. + + + + + Copy the content stream to the specified output stream. + + + This is equivalent to simply using + to copy the content stream to the output stream except that this method is cancellable. + If you want the decoded content, use + instead. + + The output stream. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously copy the content stream to the specified output stream. + + + This is equivalent to simply using + to copy the content stream to the output stream except that this method is cancellable. + If you want the decoded content, use + instead. + + An awaitable task. + The output stream. + The cancellation token. + + is null. + + + The operation was cancelled via the cancellation token. + + + An I/O error occurred. + + + + + An interface for a MIME entity. + + + A MIME entity is really just a node in a tree structure of MIME parts in a MIME message. + There are 3 basic types of entities: , , + and (which is actually just a special variation of + who's content is another MIME message/document). All other types are + derivatives of one of those. + + + + + Get the list of headers. + + + Represents the list of headers for a MIME part. Typically, the headers of + a MIME part will be various Content-* headers such as Content-Type or + Content-Disposition, but may include just about anything. + + The list of headers. + + + + Get or set the content disposition. + + + Represents the pre-parsed Content-Disposition header value, if present. + If the Content-Disposition header is not set, then this property will + be null. + + The content disposition. + + The has been disposed. + + + + + Get the type of the content. + + + The Content-Type header specifies information about the type of content contained + within the MIME entity. + + The type of the content. + + + + Get or set the base content URI. + + + The Content-Base header specifies the base URI for the + in cases where the is a relative URI. + The Content-Base URI must be an absolute URI. + For more information, see rfc2110. + + The base content URI or null. + + is not an absolute URI. + + + The has been disposed. + + + + + Get or set the content location. + + + The Content-Location header specifies the URI for a MIME entity and can be + either absolute or relative. + Setting a Content-Location URI allows other objects + within the same multipart/related container to reference this part by URI. This + can be useful, for example, when constructing an HTML message body that needs to + reference image attachments. + For more information, see rfc2110. + + The content location or null. + + The has been disposed. + + + + + Get or set the Content-Id. + + + The Content-Id header is used for uniquely identifying a particular entity and + uses the same syntax as the Message-Id header on MIME messages. + Setting a Content-Id allows other objects within the same + multipart/related container to reference this part by its unique identifier, typically + by using a "cid:" URI in an HTML-formatted message body. This can be useful, for example, + when the HTML-formatted message body needs to reference image attachments. + It is recommended that or + be used to generate a valid + Content-Id value. + + The content identifier. + + The has been disposed. + + + + + Get a value indicating whether this entity is an attachment. + + + If the Content-Disposition header is set and has a value of "attachment", + then this property returns true. Otherwise it is assumed that the + entity is not meant to be treated as an attachment. + + true if this entity is an attachment; otherwise, false. + + The has been disposed. + + + + + Dispatches to the specific visit method for this MIME entity. + + + Dispatches to the specific visit method for this MIME entity. + + The visitor. + + is null. + + + The has been disposed. + + + + + Prepare the MIME entity for transport using the specified encoding constraints. + + + Prepares the MIME entity for transport using the specified encoding constraints. + + The encoding constraint. + The maximum allowable length for a line (not counting the CRLF). Must be between 72 and 998 (inclusive). + + is not between 72 and 998 (inclusive). + -or- + is not a valid value. + + + The has been disposed. + + + + + Write the to the specified output stream. + + + Writes the headers to the output stream, followed by a blank line. + Subclasses should override this method to write the content of the entity. + + The formatting options. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Asynchronously writes the headers to the output stream, followed by a blank line. + Subclasses should override this method to write the content of the entity. + + An awaitable task. + The formatting options. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the to the specified output stream. + + + Writes the headers to the output stream, followed by a blank line. + Subclasses should override this method to write the content of the entity. + + The formatting options. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Asynchronously writes the headers to the output stream, followed by a blank line. + Subclasses should override this method to write the content of the entity. + + An awaitable task. + The formatting options. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the to the specified output stream. + + + Writes the entity to the output stream. + + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Asynchronously writes the entity to the output stream. + + An awaitable task. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the to the specified output stream. + + + Writes the entity to the output stream. + + The output stream. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Asynchronously writes the entity to the output stream. + + An awaitable task. + The output stream. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the to the specified file. + + + Writes the entity to the specified file using the provided formatting options. + + The formatting options. + The file. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified file. + + + Asynchronously writes the entity to the specified file using the provided formatting options. + + An awaitable task. + The formatting options. + The file. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Write the to the specified file. + + + Writes the entity to the specified file using the provided formatting options. + + The formatting options. + The file. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified file. + + + Asynchronously writes the entity to the specified file using the provided formatting options. + + An awaitable task. + The formatting options. + The file. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Write the to the specified file. + + + Writes the entity to the specified file using the default formatting options. + + The file. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified file. + + + Asynchronously writes the entity to the specified file using the default formatting options. + + An awaitable task. + The file. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Write the to the specified file. + + + Writes the entity to the specified file using the default formatting options. + + The file. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified file. + + + Asynchronously writes the entity to the specified file using the default formatting options. + + An awaitable task. + The file. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + An interface for a MIME message. + + + A message consists of header fields and, optionally, a body. + The body of the message can either be plain text or it can be a + tree of MIME entities such as a text/plain MIME part and a collection + of file attachments. + + + + + Get the list of headers. + + + Represents the list of headers for a message. Typically, the headers of + a message will contain transmission headers such as From and To along + with metadata headers such as Subject and Date, but may include just + about anything. + To access any MIME headers such as , + , + or any other Content-* header, you will need to access the + property of the . + + + The list of headers. + + + + Get or set the value of the Importance header. + + + Gets or sets the value of the Importance header. + + The importance. + + is not a valid . + + + + + Get or set the value of the Priority header. + + + Gets or sets the value of the Priority header. + + The priority. + + is not a valid . + + + + + Get or set the value of the X-Priority header. + + + Gets or sets the value of the X-Priority header. + + The priority. + + is not a valid . + + + + + Get or set the address in the Sender header. + + + The sender may differ from the addresses in if + the message was sent by someone on behalf of someone else. + + The address in the Sender header. + + + + Get or set the address in the Resent-Sender header. + + + The resent sender may differ from the addresses in if + the message was sent by someone on behalf of someone else. + + The address in the Resent-Sender header. + + + + Get the list of addresses in the From header. + + + The "From" header specifies the author(s) of the message. + If more than one is added to the + list of "From" addresses, the should be set to the + single of the personal actually sending + the message. + + The list of addresses in the From header. + + + + Get the list of addresses in the Resent-From header. + + + The "Resent-From" header specifies the author(s) of the messagebeing + resent. + If more than one is added to the + list of "Resent-From" addresses, the should + be set to the single of the personal actually + sending the message. + + The list of addresses in the Resent-From header. + + + + Get the list of addresses in the Reply-To header. + + + When the list of addresses in the Reply-To header is not empty, + it contains the address(es) where the author(s) of the message prefer + that replies be sent. + When the list of addresses in the Reply-To header is empty, + replies should be sent to the mailbox(es) specified in the From + header. + + The list of addresses in the Reply-To header. + + + + Get the list of addresses in the Resent-Reply-To header. + + + When the list of addresses in the Resent-Reply-To header is not empty, + it contains the address(es) where the author(s) of the resent message prefer + that replies be sent. + When the list of addresses in the Resent-Reply-To header is empty, + replies should be sent to the mailbox(es) specified in the Resent-From + header. + + The list of addresses in the Resent-Reply-To header. + + + + Get the list of addresses in the To header. + + + The addresses in the To header are the primary recipients of + the message. + + The list of addresses in the To header. + + + + Get the list of addresses in the Resent-To header. + + + The addresses in the Resent-To header are the primary recipients of + the message. + + The list of addresses in the Resent-To header. + + + + Get the list of addresses in the Cc header. + + + The addresses in the Cc header are secondary recipients of the message + and are usually not the individuals being directly addressed in the + content of the message. + + The list of addresses in the Cc header. + + + + Get the list of addresses in the Resent-Cc header. + + + The addresses in the Resent-Cc header are secondary recipients of the message + and are usually not the individuals being directly addressed in the + content of the message. + + The list of addresses in the Resent-Cc header. + + + + Get the list of addresses in the Bcc header. + + + Recipients in the Blind-Carbon-Copy list will not be visible to + the other recipients of the message. + + The list of addresses in the Bcc header. + + + + Get the list of addresses in the Resent-Bcc header. + + + Recipients in the Resent-Bcc list will not be visible to + the other recipients of the message. + + The list of addresses in the Resent-Bcc header. + + + + Get or set the subject of the message. + + + The Subject is typically a short string denoting the topic of the message. + Replies will often use "Re: " followed by the Subject of the original message. + + The subject of the message. + + is null. + + + + + Get or set the date of the message. + + + If the date is not explicitly set before the message is written to a stream, + the date will default to the exact moment when it is written to said stream. + + The date of the message. + + + + Get or set the Resent-Date of the message. + + + Gets or sets the Resent-Date of the message. + + The Resent-Date of the message. + + + + Get the list of references to other messages. + + + The References header contains a chain of Message-Ids back to the + original message that started the thread. + + The references. + + + + Get or set the Message-Id that this message is replying to. + + + If the message is a reply to another message, it will typically + use the In-Reply-To header to specify the Message-Id of the + original message being replied to. + + The message id that this message is in reply to. + + is improperly formatted. + + + + + Get or set the message identifier. + + + The Message-Id is meant to be a globally unique identifier for + a message. + can be used + to generate this value. + + The message identifier. + + is null. + + + is improperly formatted. + + + + + Get or set the Resent-Message-Id header. + + + The Resent-Message-Id is meant to be a globally unique identifier for + a message. + can be used + to generate this value. + + The Resent-Message-Id. + + is null. + + + is improperly formatted. + + + + + Get or set the MIME-Version. + + + The MIME-Version header specifies the version of the MIME specification + that the message was created for. + + The MIME version. + + is null. + + + + + Get or set the body of the message. + + + The body of the message can either be plain text or it can be a + tree of MIME entities such as a text/plain MIME part and a collection + of file attachments. + For a convenient way of constructing message bodies, see the + class. + + The body of the message. + + + + Get the text body of the message if it exists. + + + Gets the text content of the first text/plain body part that is found (in depth-first + search order) which is not an attachment. + + The text body if it exists; otherwise, null. + + + + Get the html body of the message if it exists. + + + Gets the HTML-formatted body of the message if it exists. + + The html body if it exists; otherwise, null. + + + + Get the text body in the specified format. + + + Gets the text body in the specified format, if it exists. + + The text body in the desired format if it exists; otherwise, null. + The desired text format. + + + + Get the body parts of the message. + + + Traverses over the MIME tree, enumerating all of the objects, + but does not traverse into the bodies of attached messages. + + + + + The body parts. + + + + Get the attachments. + + + Traverses over the MIME tree, enumerating all of the objects that + have a Content-Disposition header set to "attachment". + + + + + The attachments. + + + + Dispatches to the specific visit method for this MIME message. + + + Dispatches to the specific visit method for this MIME message. + + The visitor. + + is null. + + + + + Prepare the message for transport using the specified encoding constraints. + + + Prepares the message for transport using the specified encoding constraints. + + The encoding constraint. + The maximum allowable length for a line (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + -or- + is not a valid value. + + + + + Write the message to the specified output stream. + + + Writes the message to the output stream using the provided formatting options. + + The formatting options. + The output stream. + true if only the headers should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified output stream. + + + Asynchronously writes the message to the output stream using the provided formatting options. + + An awaitable task. + The formatting options. + The output stream. + true if only the headers should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the message to the specified output stream. + + + Writes the message to the output stream using the provided formatting options. + + The formatting options. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified output stream. + + + Asynchronously writes the message to the output stream using the provided formatting options. + + An awaitable task. + The formatting options. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the message to the specified output stream. + + + Writes the message to the output stream using the default formatting options. + + The output stream. + true if only the headers should be written; otherwise, false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified output stream. + + + Asynchronously writes the message to the output stream using the default formatting options. + + An awaitable task. + The output stream. + true if only the headers should be written; otherwise, false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the message to the specified output stream. + + + Writes the message to the output stream using the default formatting options. + + The output stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified output stream. + + + Asynchronously writes the message to the output stream using the default formatting options. + + An awaitable task. + The output stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the message to the specified file. + + + Writes the message to the specified file using the provided formatting options. + + The formatting options. + The file. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified file. + + + Asynchronously writes the message to the specified file using the provided formatting options. + + An awaitable task. + The formatting options. + The file. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Write the message to the specified file. + + + Writes the message to the specified file using the default formatting options. + + The file. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified file. + + + Asynchronously writes the message to the specified file using the default formatting options. + + An awaitable task. + The file. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + An interface for parsing messages, entities, and/or headers. + + + An interface for parsing messages, entities, and/or headers. Implemented by and + . + + + + + Get or set the parser options. + + + Gets or sets the parser options. + + The parser options. + + + + Get a value indicating whether the parser has reached the end of the input stream. + + + Gets a value indicating whether the parser has reached the end of the input stream. + + true if this parser has reached the end of the input stream; + otherwise, false. + + + + Get the current position of the parser within the stream. + + + Gets the current position of the parser within the stream. + + The stream offset. + + + + Gets the most recent mbox marker offset. + + + Gets the most recent mbox marker offset. + + The mbox marker offset. + + + + Gets the most recent mbox marker. + + + Gets the most recent mbox marker. + + The mbox marker. + + + + Set the stream to parse. + + + Sets the stream to parse. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The stream to parse. + The format of the stream. + true if the stream is persistent; otherwise false. + + is null. + + + + + Set the stream to parse. + + + Sets the stream to parse. + + The stream to parse. + The format of the stream. + + is null. + + + + + Set the stream to parse. + + + Sets the stream to parse. + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + It should be noted, however, that disposing will make it impossible + for to read the content. + + The stream to parse. + true if the stream is persistent; otherwise false. + + is null. + + + + + Parse a list of headers from the stream. + + + Parses a list of headers from the stream. + + The parsed list of headers. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Asynchronously parse a list of headers from the stream. + + + Asynchronously parses a list of headers from the stream. + + The parsed list of headers. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the headers. + + + An I/O error occurred. + + + + + Parse an entity from the stream. + + + Parses an entity from the stream. + + The parsed entity. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously parse an entity from the stream. + + + Asynchronously parses an entity from the stream. + + The parsed entity. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Parse a message from the stream. + + + Parses a message from the stream. + + The parsed message. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the message. + + + An I/O error occurred. + + + + + Asynchronously parse a message from the stream. + + + Asynchronously parses a message from the stream. + + The parsed message. + The cancellation token. + + The operation was canceled via the cancellation token. + + + There was an error parsing the message. + + + An I/O error occurred. + + + + + An interface for a leaf-node MIME part that contains content such as the message body text or an attachment. + + + A leaf-node MIME part that contains content such as the message body text or an attachment. + + + + + + + + Get or set the description of the content if available. + + + The Content-Description header can be used to set a description of the content. + + The description of the content. + + is negative. + + + The has been disposed. + + + + + Get or set the duration of the content if available. + + + The Content-Duration header specifies duration of timed media, + such as audio or video, in seconds. + + The duration of the content. + + is negative. + + + The has been disposed. + + + + + Get or set the md5sum of the content. + + + The Content-MD5 header specifies the base64-encoded MD5 checksum of the content + in its canonical format. + For more information, see rfc1864. + + The md5sum of the content. + + The has been disposed. + + + + + Get or set the content transfer encoding. + + + The Content-Transfer-Encoding header specifies an auxiliary encoding + that was applied to the content in order to allow it to pass through + mail transport mechanisms (such as SMTP) which may have limitations + in the byte ranges that it accepts. For example, many SMTP servers + do not accept data outside of the 7-bit ASCII range and so sending + binary attachments or even non-English text is not possible without + applying an encoding such as base64 or quoted-printable. + + The content transfer encoding. + + is not a valid content encoding. + + + The has been disposed. + + + + + Get or set the name of the file. + + + First checks for the "filename" parameter on the Content-Disposition header. If + that does not exist, then the "name" parameter on the Content-Type header is used. + When setting the filename, both the "filename" parameter on the Content-Disposition + header and the "name" parameter on the Content-Type header are set. + + + + + The name of the file. + + The has been disposed. + + + + + Get or set the MIME content. + + + Gets or sets the MIME content. + + + + + The MIME content. + + + + Calculate the most efficient content encoding given the specified constraint. + + + If no is set, will be returned. + + The most efficient content encoding. + The encoding constraint. + The cancellation token. + + is not a valid value. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Calculate the most efficient content encoding given the specified constraint. + + + If no is set, will be returned. + + The most efficient content encoding. + The encoding constraint. + The maximum allowable length for a line (not counting the CRLF). Must be between 72 and 998 (inclusive). + The cancellation token. + + is not between 72 and 998 (inclusive). + -or- + is not a valid value. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Compute the MD5 checksum of the content. + + + Computes the MD5 checksum of the MIME content in its canonical + format and then base64-encodes the result. + + The md5sum of the content. + + The has been disposed. + + + The is null. + + + + + Verify the Content-Md5 value against an independently computed md5sum. + + + Computes the MD5 checksum of the MIME content and compares it with the + value in the Content-MD5 header, returning true if and only if + the values match. + + true, if content MD5 checksum was verified, false otherwise. + + The has been disposed. + + + + + An interface for a multipart MIME entity which may contain a collection of MIME entities. + + + All multipart MIME entities will have a Content-Type with a media type of "multipart". + The most common multipart MIME entity used in email is the "multipart/mixed" entity. + Four (4) initial subtypes were defined in the original MIME specifications: mixed, alternative, + digest, and parallel. + The "multipart/mixed" type is a sort of general-purpose container. When used in email, the + first entity is typically the "body" of the message while additional entities are most often + file attachments. + Speaking of message "bodies", the "multipart/alternative" type is used to offer a list of + alternative formats for the main body of the message (usually they will be "text/plain" and + "text/html"). These alternatives are in order of increasing faithfulness to the original document + (in other words, the last entity will be in a format that, when rendered, will most closely match + what the sending client's WYSISYG editor produced). + The "multipart/digest" type will typically contain a digest of MIME messages and is most + commonly used by mailing-list software. + The "multipart/parallel" type contains entities that are all meant to be shown (or heard) + in parallel. + Another commonly used type is the "multipart/related" type which contains, as one might expect, + inter-related MIME parts which typically reference each other via URIs based on the Content-Id and/or + Content-Location headers. + + + + + Get or set the boundary. + + + Gets or sets the boundary parameter on the Content-Type header. + + The boundary. + + is null. + + + + + Get or set the preamble. + + + A multipart preamble appears before the first child entity of the + multipart and is typically used only in the top-level multipart + of the message to specify that the message is in MIME format and + therefore requires a MIME compliant email application to render + it correctly. + + The preamble. + + The has been disposed. + + + + + Get or set the epilogue. + + + A multipart epiloque is the text that appears after the closing boundary + of the multipart and is typically either empty or a single new line + character sequence. + + The epilogue. + + The has been disposed. + + + + + An interface for a multipart/alternative MIME entity. + + + A multipart/alternative MIME entity contains, as one might expect, is used to offer a list of + alternative formats for the main body of the message (usually they will be "text/plain" and + "text/html"). These alternatives are in order of increasing faithfulness to the original document + (in other words, the last entity will be in a format that, when rendered, will most closely match + what the sending client's WYSISYG editor produced). + + + + + Get the text of the text/plain alternative. + + + Gets the text of the text/plain alternative, if it exists. + + The text if a text/plain alternative exists; otherwise, null. + + The has been disposed. + + + + + Get the HTML-formatted text of the text/html alternative. + + + Gets the HTML-formatted text of the text/html alternative, if it exists. + + The HTML if a text/html alternative exists; otherwise, null. + + The has been disposed. + + + + + Get the text body in the specified format. + + + Gets the text body in the specified format, if it exists. + + The text body in the desired format if it exists; otherwise, null. + The desired text format. + + The has been disposed. + + + + + An interface for a multipart/related MIME entity. + + + A multipart/related MIME entity contains, as one might expect, inter-related MIME parts which + typically reference each other via URIs based on the Content-Id and/or Content-Location headers. + + + + + + + + Get or set the root document of the multipart/related part and the appropriate Content-Type parameters. + + + Gets or sets the root document that references the other MIME parts within the multipart/related. + When getting the root document, the "start" parameter of the Content-Type header is used to + determine which of the parts is the root. If the "start" parameter does not exist or does not reference + any of the child parts, then the first child is assumed to be the root. + When setting the root document MIME part, the Content-Type header of the multipart/related part is also + updated with a appropriate "start" and "type" parameters. + + + + + The root MIME part. + + is null. + + + The has been disposed. + + + + + Check if the contains a part matching the specified URI. + + + Determines whether or not the multipart/related entity contains a part matching the specified URI. + + true if the specified part exists; otherwise false. + The URI of the MIME part. + + is null. + + + The has been disposed. + + + + + Get the index of the part matching the specified URI. + + + Finds the index of the part matching the specified URI, if it exists. + If the URI scheme is "cid", then matching is performed based on the Content-Id header + values, otherwise the Content-Location headers are used. If the provided URI is absolute and a child + part's Content-Location is relative, then then the child part's Content-Location URI will be combined + with the value of its Content-Base header, if available, otherwise it will be combined with the + multipart/related part's Content-Base header in order to produce an absolute URI that can be + compared with the provided absolute URI. + + + + + The index of the part matching the specified URI if found; otherwise -1. + The URI of the MIME part. + + is null. + + + The has been disposed. + + + + + Open a stream for reading the decoded content of the MIME part specified by the provided URI. + + + Opens a stream for reading the decoded content of the MIME part specified by the provided URI. + + A stream for reading the decoded content of the MIME part specified by the provided URI. + The URI. + The mime-type of the content. + The charset of the content (if the content is text-based) + + is null. + + + The MIME part for the specified URI could not be found. + + + The has been disposed. + + + + + Open a stream for reading the decoded content of the MIME part specified by the provided URI. + + + Opens a stream for reading the decoded content of the MIME part specified by the provided URI. + + A stream for reading the decoded content of the MIME part specified by the provided URI. + The URI. + + is null. + + + The MIME part for the specified URI could not be found. + + + The has been disposed. + + + + + An interface for a multipart/report MIME entity. + + + A multipart/related MIME entity is a general container part for electronic mail + reports of any kind. + + + + + + + + + + Get or set the type of the report. + + + Gets or sets the type of the report. + The report type should be the subtype of the second + of the multipart/report. + + + + + The type of the report. + + is null. + + + The has been disposed. + + + + + An abstract internet address, as specified by rfc0822. + + + An can be any type of address defined by the + original Internet Message specification. + There are effectively two (2) types of addresses: mailboxes and groups. + Mailbox addresses are what are most commonly known as email addresses and are + represented by the class. + Group addresses are themselves lists of addresses and are represented by the + class. While rare, it is still important to handle these + types of addresses. They typically only contain mailbox addresses, but may also + contain other group addresses. + + + + + Initialize a new instance of the class. + + + Initializes the and properties of the internet address. + + The character encoding to be used for encoding the name. + The name of the mailbox or group. + + is null. + + + + + Get or set the character encoding to use when encoding the name of the address. + + + The character encoding is used to convert the property, if it is set, + to a stream of bytes when encoding the internet address for transport. + + The character encoding. + + is null. + + + + + Get or set the display name of the address. + + + A name is optional and is typically set to the name of the person + or group that own the internet address. + For example, the property of the following would be "John Smith". + John Smith <j.smith@example.com> + Likewise, the property of the following would be "undisclosed-recipients". + undisclosed-recipients: Alice <alice@wonderland.com>, Bob <bob@the-builder.com>; + + The name of the address. + + + + Clone the address. + + + Clones the address. + + The cloned address. + + + + Compares two internet addresses. + + + Compares two internet addresses for the purpose of sorting. + + The sort order of the current internet address compared to the other internet address. + The internet address to compare to. + + is null. + + + + + Determine whether the specified is equal to the current . + + + Compares two internet addresses to determine if they are identical or not. + + The to compare with the current . + true if the specified is equal to the current + ; otherwise, false. + + + + Determine whether the specified object is equal to the current object. + + + The type of comparison between the current instance and the parameter depends on whether + the current instance is a reference type or a value type. + + The object to compare with the current object. + true if the specified object is equal to the current object; otherwise, false. + + + + Return the hash code for this instance. + + + Returns the hash code for this instance. + + A hash code for the current object. + + + + Serialize an to a string, optionally encoding it for transport. + + + If the parameter is true, then this method will return + an encoded version of the internet address according to the rules described in rfc2047. + However, if the parameter is false, then this method will + return a string suitable only for display purposes. + + A string representing the . + The formatting options. + If set to true, the will be encoded. + + is null. + + + + + Serialize an to a string, optionally encoding it for transport. + + + If the parameter is true, then this method will return + an encoded version of the internet address according to the rules described in rfc2047. + However, if the parameter is false, then this method will + return a string suitable only for display purposes. + + A string representing the . + If set to true, the will be encoded. + + + + Serialize an to a string suitable for display. + + + The string returned by this method is suitable only for display purposes. + + A string representing the . + + + + Raise the internal changed event used by to keep headers in sync. + + + This method is called whenever a property of the internet address is changed. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed address. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed address. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The starting index of the input buffer. + The parsed address. + + is null. + -or- + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The parsed address. + + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The parsed address. + + is null. + -or- + is null. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The input buffer. + The parsed address. + + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a single or . If the text contains + more data, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The text. + The parsed address. + + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a single or . If the text contains + more data, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The text. + The parsed address. + + is null. + + + + + Parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + The parsed . + The parser options to use. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + The parsed . + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + + is null. + + + and do not specify + a valid range in the byte array. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + The parsed . + The parser options to use. + The input buffer. + The starting index of the input buffer. + + is null. + -or- + is null. + + + is out of range. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + The parsed . + The input buffer. + The starting index of the input buffer. + + is null. + + + is out of range. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + The parsed . + The parser options to use. + The input buffer. + + is null. + -or- + is null. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single or . If the buffer contains + more data, then parsing will fail. + + The parsed . + The input buffer. + + is null. + + + could not be parsed. + + + + + Parse the given text into a new instance. + + + Parses a single or . If the text contains + more data, then parsing will fail. + + The parsed . + The parser options to use. + The text. + + is null. + -or- + is null. + + + could not be parsed. + + + + + Parse the given text into a new instance. + + + Parses a single or . If the text contains + more data, then parsing will fail. + + The parsed . + The text. + + is null. + + + could not be parsed. + + + + + A list of email addresses. + + + An may contain any number of addresses of any type + defined by the original Internet Message specification. + There are effectively two (2) types of addresses: mailboxes and groups. + Mailbox addresses are what are most commonly known as email addresses and are + represented by the class. + Group addresses are themselves lists of addresses and are represented by the + class. While rare, it is still important to handle these + types of addresses. They typically only contain mailbox addresses, but may also + contain other group addresses. + + + + + Initialize a new instance of the class. + + + Creates a new containing the supplied addresses. + + An initial list of addresses. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new, empty, . + + + + + Recursively get all of the mailboxes contained within the . + + + This API is useful for collecting a flattened list of + recipients for use with sending via SMTP or for encrypting via S/MIME or PGP/MIME. + + The mailboxes. + + + + Get the index of the specified address. + + + Finds the index of the specified address, if it exists. + + The index of the specified address if found; otherwise -1. + The address to get the index of. + + is null. + + + + + Insert an address at the specified index. + + + Inserts the address at the specified index in the list. + + The index to insert the address. + The address. + + is null. + + + is out of range. + + + + + Remove the address at the specified index. + + + Removes the address at the specified index. + + The index of the address to remove. + + is out of range. + + + + + Get or set the at the specified index. + + + Gets or sets the at the specified index. + + The internet address at the specified index. + The index of the address to get or set. + + is null. + + + is out of range. + + + + + Get the number of addresses in the . + + + Indicates the number of addresses in the list. + + The number of addresses. + + + + Get a value indicating whether the is read only. + + + A is never read-only. + + true if this instance is read only; otherwise, false. + + + + Add an address to the . + + + Adds the specified address to the end of the address list. + + The address. + + is null. + + + + + Add a collection of addresses to the . + + + Adds a range of addresses to the end of the address list. + + A colelction of addresses. + + is null. + + + + + Clear the address list. + + + Removes all of the addresses from the list. + + + + + Check if the contains the specified address. + + + Determines whether or not the address list contains the specified address. + + true if the specified address exists; + otherwise false. + The address. + + is null. + + + + + Copy all of the addresses in the to the specified array. + + + Copies all of the addresses within the into the array, + starting at the specified array index. + + The array to copy the addresses to. + The index into the array. + + is null. + + + is out of range. + + + + + Remove the specified address from the . + + + Removes the specified address. + + true if the address was removed; otherwise false. + The address. + + is null. + + + + + Get an enumerator for the list of addresses. + + + Gets an enumerator for the list of addresses. + + The enumerator. + + + + Get an enumerator for the list of addresses. + + + Gets an enumerator for the list of addresses. + + The enumerator. + + + + Determine whether the specified is equal to the current . + + + 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. + + + + Compare two internet address lists. + + + Compares two internet address lists for the purpose of sorting. + + The sort order of the current internet address list compared to the other internet address list. + The internet address list to compare to. + + is null. + + + + + Determine whether the specified object is equal to the current object. + + + The type of comparison between the current instance and the parameter depends on whether + the current instance is a reference type or a value type. + + The object to compare with the current object. + true if the specified object is equal to the current object; otherwise, false. + + + + Return the hash code for this instance. + + + Returns the hash code for this instance. + + A hash code for the current object. + + + + Serialize an to a string, optionally encoding the list of addresses for transport. + + + If is true, each address in the list will be encoded + according to the rules defined in rfc2047. + If there are multiple addresses in the list, they will be separated by a comma. + + A string representing the . + The formatting options. + If set to true, each in the list will be encoded. + + + + Serialize an to a string, optionally encoding the list of addresses for transport. + + + If is true, each address in the list will be encoded + according to the rules defined in rfc2047. + If there are multiple addresses in the list, they will be separated by a comma. + + A string representing the . + If set to true, each in the list will be encoded. + + + + Serialize an to a string suitable for display. + + + If there are multiple addresses in the list, they will be separated by a comma. + + A string representing the . + + + + Try to parse the given input buffer into a new instance. + + + Parses a list of addresses from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + true, if the address list was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed addresses. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a list of addresses from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + true, if the address list was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed addresses. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a list of addresses from the supplied buffer starting at the specified index. + + true, if the address list was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The starting index of the input buffer. + The parsed addresses. + + is null. + -or- + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a list of addresses from the supplied buffer starting at the specified index. + + true, if the address list was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The parsed addresses. + + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a list of addresses from the specified buffer. + + true, if the address list was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The parsed addresses. + + is null. + -or- + is null. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a list of addresses from the specified buffer. + + true, if the address list was successfully parsed, false otherwise. + The input buffer. + The parsed addresses. + + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a list of addresses from the specified text. + + true, if the address list was successfully parsed, false otherwise. + The parser options to use. + The text. + The parsed addresses. + + is null. + -or- + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a list of addresses from the specified text. + + true, if the address list was successfully parsed, false otherwise. + The text. + The parsed addresses. + + is null. + + + + + Parse the given input buffer into a new instance. + + + Parses a list of addresses from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + The parsed . + The parser options to use. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a list of addresses from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + The parsed . + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + + is null. + + + and do not specify + a valid range in the byte array. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a list of addresses from the supplied buffer starting at the specified index. + + The parsed . + The parser options to use. + The input buffer. + The starting index of the input buffer. + + is null. + -or- + is null. + + + is out of range. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a list of addresses from the supplied buffer starting at the specified index. + + The parsed . + The input buffer. + The starting index of the input buffer. + + is null. + + + is out of range. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a list of addresses from the specified buffer. + + The parsed . + The parser options to use. + The input buffer. + + is null. + -or- + is null. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a list of addresses from the specified buffer. + + The parsed . + The input buffer. + + is null. + + + could not be parsed. + + + + + Parse the given text into a new instance. + + + Parses a list of addresses from the specified text. + + The parsed . + The parser options to use. + The text. + + is null. + -or- + is null. + + + could not be parsed. + + + + + Parse the given text into a new instance. + + + Parses a list of addresses from the specified text. + + The parsed . + The text. + + is null. + + + could not be parsed. + + + + + Explicit cast to convert a to a + . + + + Casts a to a + in cases where you might want to make use of the System.Net.Mail APIs. + + The equivalent . + The addresses. + + contains one or more group addresses and cannot be converted. + + + + + Explicit cast to convert a + to a . + + + Casts a to a + in cases where you might want to make use of the the superior MimeKit APIs. + + The equivalent . + The mail address. + + + + A bounded stream, confined to reading and writing data to a limited subset of the overall source stream. + + + Wraps an arbitrary stream, limiting I/O operations to a subset of the source stream. + If the is -1, then the end of the stream is unbound. + When a is set to parse a persistent stream, it will construct + s using bounded streams instead of loading the content into memory. + + + + + Initialize a new instance of the class. + + + If the is less than 0, then the end of the stream + is unbounded. + + The underlying stream. + The offset in the base stream that will mark the start of this substream. + The offset in the base stream that will mark the end of this substream. + true to leave the baseStream open after the + is disposed; otherwise, false. + + is null. + + + is less than zero. + -or- + is greater than or equal to zero + -and- is less than . + + + + + Get the underlying stream. + + + All I/O is performed on the base stream. + + The underlying stream. + + + + Get the start boundary offset of the underlying stream. + + + The start boundary is the byte offset into the + that marks the beginning of the substream. + + The start boundary offset of the underlying stream. + + + + Get the end boundary offset of the underlying stream. + + + The end boundary is the byte offset into the + that marks the end of the substream. If the value is less than 0, + then the end of the stream is treated as unbound. + + The end boundary offset of the underlying stream. + + + + Check whether or not the underlying stream will remain open after + the is disposed. + + + Checks whether or not the underlying stream will remain open after + the is disposed. + + true if the underlying stream should remain open after the + is disposed; otherwise, false. + + + + Check whether or not the stream supports reading. + + + The will only support reading if the + supports it. + + true if the stream supports reading; otherwise, false. + + + + Check whether or not the stream supports writing. + + + The will only support writing if the + supports it. + + true if the stream supports writing; otherwise, false. + + + + Check whether or not the stream supports seeking. + + + The will only support seeking if the + supports it. + + true if the stream supports seeking; otherwise, false. + + + + Check whether or not I/O operations can timeout. + + + The will only support timing out if the + supports it. + + true if I/O operations can timeout; otherwise, false. + + + + Get the length of the stream, in bytes. + + + If the property is greater than or equal to 0, + then the length will be calculated by subtracting the + from the . If the end of the stream is unbound, then the + will be subtracted from the length of the + . + + The length of the stream in bytes. + + The stream does not support seeking. + + + The stream has been disposed. + + + + + Get or sets the current position within the stream. + + + The is relative to the . + + The position of the stream. + + An I/O error occurred. + + + The stream does not support seeking. + + + The stream has been disposed. + + + + + Get or sets a value, in milliseconds, that determines how long the stream will attempt to read before timing out. + + + Gets or sets the 's read timeout. + + A value, in milliseconds, that determines how long the stream will attempt to read before timing out. + + + + Get or sets a value, in milliseconds, that determines how long the stream will attempt to write before timing out. + + + Gets or sets the 's write timeout. + + A value, in milliseconds, that determines how long the stream will attempt to write before timing out. + + + + Read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reads data from the , not allowing it to + read beyond the . + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if + that many bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support reading. + + + An I/O error occurred. + + + + + Asynchronously read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reads data from the , not allowing it to + read beyond the . + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if + that many bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + The cancellation token. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support reading. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Writes data to the , not allowing it to + write beyond the . + + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Asynchronously write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Writes data to the , not allowing it to + write beyond the . + + A task that represents the asynchronous write operation. + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + The cancellation token. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Set the position within the current stream. + + + Seeks within the confines of the and the . + + The new position within the stream. + The offset into the stream relative to the . + The origin to seek from. + + is not a valid . + + + The stream has been disposed. + + + The stream does not support seeking. + + + An I/O error occurred. + + + + + Clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + Flushes the . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Asynchronously clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + Flushes the . + + A task that represents the asynchronous flush operation. + The cancellation token. + + The stream has been disposed. + + + The stream does not support writing. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Set the length of the stream. + + + Updates the to be plus + the specified new length. If the needs to be grown + to allow this, then the length of the will also be + updated. + + The desired length of the stream in bytes. + + The stream has been disposed. + + + The stream does not support setting the length. + + + An I/O error occurred. + + + + + Release the unmanaged resources used by the and + optionally releases the managed resources. + + + If the property is false, then + the is also disposed. + + true to release both managed and unmanaged resources; + false to release only the unmanaged resources. + + + + A chained stream. + + + Chains multiple streams together such that reading or writing beyond the end + of one stream spills over into the next stream in the chain. The idea is to + make it appear is if the chain of streams is all one continuous stream. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Add a stream to the chained stream. + + + Adds the stream to the end of the chain. + + The stream. + true if the + should remain open after the is disposed; + otherwise, false. + + is null. + + + + + Check whether or not the stream supports reading. + + + The only supports reading if all of its + streams support it. + + true if the stream supports reading; otherwise, false. + + + + Check whether or not the stream supports writing. + + + The only supports writing if all of its + streams support it. + + true if the stream supports writing; otherwise, false. + + + + Check whether or not the stream supports seeking. + + + The only supports seeking if all of its + streams support it. + + true if the stream supports seeking; otherwise, false. + + + + Check whether or not I/O operations can timeout. + + + The only supports timeouts if all of its + streams support them. + + true if I/O operations can timeout; otherwise, false. + + + + Get the length of the stream, in bytes. + + + The length of a is the combined lenths of all + of its chained streams. + + The length of the stream in bytes. + + The stream does not support seeking. + + + The stream has been disposed. + + + + + Get or set the current position within the stream. + + + It is always possible to get the position of a , + but setting the position is only possible if all of its streams are seekable. + + The position of the stream. + + An I/O error occurred. + + + The stream does not support seeking. + + + The stream has been disposed. + + + + + Read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reads up to the requested number of bytes if reading is supported. If the + current child stream does not have enough remaining data to complete the + read, the read will progress into the next stream in the chain in order + to complete the read. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if + that many bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support reading. + + + An I/O error occurred. + + + + + Asynchronously read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reads up to the requested number of bytes if reading is supported. If the + current child stream does not have enough remaining data to complete the + read, the read will progress into the next stream in the chain in order + to complete the read. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if + that many bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + The cancellation token. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support reading. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Writes the requested number of bytes if writing is supported. If the + current child stream does not have enough remaining space to fit the + complete buffer, the data will spill over into the next stream in the + chain in order to complete the write. + + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Asynchronously write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Writes the requested number of bytes if writing is supported. If the + current child stream does not have enough remaining space to fit the + complete buffer, the data will spill over into the next stream in the + chain in order to complete the write. + + A task that represents the asynchronous write operation. + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + The cancellation token. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Set the position within the current stream. + + + Seeks to the specified position within the stream if all child streams + support seeking. + + The new position within the stream. + The offset into the stream relative to the . + The origin to seek from. + + is not a valid . + + + The stream has been disposed. + + + The stream does not support seeking. + + + An I/O error occurred. + + + + + Clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + If all of the child streams support writing, then the current child stream + will be flushed. + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Asynchronously clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + If all of the child streams support writing, then the current child stream + will be flushed. + + A task that represents the asynchronous flush operation. + The cancellation token. + + The stream has been disposed. + + + The stream does not support writing. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Set the length of the stream. + + + Setting the length of a is not supported. + + The desired length of the stream in bytes. + + The stream has been disposed. + + + The stream does not support setting the length. + + + + + Release the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + A stream which filters data as it is read or written. + + + Passes data through each as the data is read or written. + + + + + Initialize a new instance of the class. + + + Creates a filtered stream using the specified source stream. + + The underlying stream to filter. + + is null. + + + + + Get the underlying source stream. + + + In general, it is not a good idea to manipulate the underlying + source stream because most s store + important state about previous bytes read from or written to + the source stream. + + The underlying source stream. + + + + Add a filter. + + + Adds the to the end of the list of filters + that data will pass through as data is read from or written to the + underlying source stream. + + The filter. + + is null. + + + + + Check if the filtered stream contains the specified filter. + + + Determines whether or not the filtered stream contains the specified filter. + + true if the specified filter exists; + otherwise false. + The filter. + + is null. + + + + + Remove a filter. + + + Removes the specified filter from the list if it exists. + + true if the filter was removed; otherwise false. + The filter. + + is null. + + + + + Check whether or not the stream supports reading. + + + The will only support reading if the + supports it. + + true if the stream supports reading; otherwise, false. + + + + Check whether or not the stream supports writing. + + + The will only support writing if the + supports it. + + true if the stream supports writing; otherwise, false. + + + + Check whether or not the stream supports seeking. + + + Seeking is not supported by the . + + true if the stream supports seeking; otherwise, false. + + + + Check whether or not I/O operations can timeout. + + + The will only support timing out if the + supports it. + + true if I/O operations can timeout; otherwise, false. + + + + Get the length of the stream, in bytes. + + + Getting the length of a is not supported. + + The length of the stream in bytes. + + The stream does not support seeking. + + + + + Get or set the current position within the stream. + + + Getting and setting the position of a is not supported. + + The position of the stream. + + The stream does not support seeking. + + + + + Get or set a value, in milliseconds, that determines how long the stream will attempt to read before timing out. + + + Gets or sets the read timeout on the stream. + + A value, in milliseconds, that determines how long the stream will attempt to read before timing out. + + + + Get or set a value, in milliseconds, that determines how long the stream will attempt to write before timing out. + + + Gets or sets the write timeout on the stream. + + A value, in milliseconds, that determines how long the stream will attempt to write before timing out. + + + + Read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reads up to the requested number of bytes, passing the data read from the stream + through each of the filters before finally copying the result into the provided buffer. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if + that many bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + The cancellation token. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support reading. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reads up to the requested number of bytes, passing the data read from the stream + through each of the filters before finally copying the result into the provided buffer. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if + that many bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support reading. + + + An I/O error occurred. + + + + + Asynchronously read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reads up to the requested number of bytes, passing the data read from the stream + through each of the filters before finally copying the result into the provided buffer. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if + that many bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + The cancellation token. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support reading. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Filters the provided buffer through each of the filters before finally writing + the result to the underlying stream. + + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + The cancellation token. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Filters the provided buffer through each of the filters before finally writing + the result to the underlying stream. + + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Asynchronously write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Filters the provided buffer through each of the filters before finally writing + the result to the underlying stream. + + A task that represents the asynchronous write operation. + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + The cancellation token. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Set the position within the current stream. + + + Seeking is not supported by the . + + The new position within the stream. + The offset into the stream relative to the . + The origin to seek from. + + The stream does not support seeking. + + + + + Clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + Flushes the state of all filters, writing any output to the underlying + stream and then calling on the . + + The cancellation token. + + The stream has been disposed. + + + The stream does not support writing. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + Flushes the state of all filters, writing any output to the underlying + stream and then calling on the . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Asynchronously clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + Flushes the state of all filters, writing any output to the underlying + stream and then calling on the . + + A task that represents the asynchronous flush operation. + The cancellation token. + + The stream has been disposed. + + + The stream does not support writing. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Set the length of the stream. + + + Setting the length of a is not supported. + + The desired length of the stream in bytes. + + The stream has been disposed. + + + The stream does not support setting the length. + + + + + Release the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + A filter that armors lines beginning with "From " by encoding the 'F' with the + Quoted-Printable encoding. + + + From-armoring is a workaround to prevent receiving clients and/or servers + that use the mbox file format for local storage from munging every line of the + message content beginning with "From " by prepending a ">" to each of those lines, + as is typical with software using the mbox format. + This armoring technique ensures that the receiving client will still + be able to verify PGP/MIME and S/MIME signatures. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Reset the filter. + + + Resets the filter. + + + + + A filter that can be used to determine the most efficient Content-Transfer-Encoding. + + + Keeps track of the content that gets passed through the filter in order to + determine the most efficient to use. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Get the best encoding given the specified constraints. + + + Gets the best encoding given the specified constraints. + + The best encoding. + The encoding constraint. + The maximum allowable line length (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + -or- + is not a valid value. + + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The number of bytes of the input to filter. + The starting index of the output in the returned buffer. + The length of the output buffer. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Filter the specified input, flushing all internally buffered data to the output. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The number of bytes of the input to filter. + The starting index of the output in the returned buffer. + The length of the output buffer. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Reset the filter. + + + Resets the filter. + + + + + A charset filter for incrementally converting text streams from + one charset encoding to another. + + + Incrementally converts text from one charset encoding to another. + + + + + Initialize a new instance of the class. + + + Creates a new to convert text from the specified + source encoding into the target charset encoding. + + Source encoding name. + Target encoding name. + + is null. + -or- + is null. + + + The is not supported by the system. + -or- + The is not supported by the system. + + + + + Initialize a new instance of the class. + + + Creates a new to convert text from the specified + source encoding into the target charset encoding. + + Source code page. + Target code page. + + is less than zero or greater than 65535. + -or- + is less than zero or greater than 65535. + + + The is not supported by the system. + -or- + The is not supported by the system. + + + + + Initialize a new instance of the class. + + + Creates a new to convert text from the specified + source encoding into the target charset encoding. + + Source encoding. + Target encoding. + + is null. + -or- + is null. + + + + + Get the source encoding. + + + Gets the source encoding. + + The source encoding. + + + + Get the target encoding. + + + Gets the target encoding. + + The target encoding. + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Reset the filter. + + + Resets the filter. + + + + + A filter for decoding MIME content. + + + Uses a to incrementally decode data. + + + + + Get the decoder used by this filter. + + + Gets the decoder used by this filter. + + The decoder. + + + + Get the encoding. + + + Gets the encoding that the decoder supports. + + The encoding. + + + + Initialize a new instance of the class. + + + Creates a new using the specified decoder. + + A specific decoder for the filter to use. + + is null. + + + + + Create a filter that will decode the specified encoding. + + + Creates a new for the specified encoding. + + A new decoder filter. + The encoding to create a filter for. + + + + Create a filter that will decode the specified encoding. + + + Creates a new for the specified encoding. + + A new decoder filter. + The name of the encoding to create a filter for. + + is null. + + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Reset the filter. + + + Resets the filter. + + + + + A filter that will convert from Windows/DOS line endings to Unix line endings. + + + Converts from Windows/DOS line endings to Unix line endings. + + + + + Initialize a new instance of the class. + + + Creates a new . + + Ensure that the stream ends with a new line. + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Reset the filter. + + + Resets the filter. + + + + + A filter for encoding MIME content. + + + Uses a to incrementally encode data. + + + + + Get the encoder used by this filter. + + + Gets the encoder used by this filter. + + The encoder. + + + + Get the encoding. + + + Gets the encoding that the encoder supports. + + The encoding. + + + + Initialize a new instance of the class. + + + Creates a new using the specified encoder. + + A specific encoder for the filter to use. + + is null. + + + + + Create a filter that will encode using specified encoding. + + + Creates a new for the specified encoding. + + A new encoder filter. + The encoding to create a filter for. + The maximum number of octets allowed per line (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + + + + + Create a filter that will encode using specified encoding. + + + Creates a new for the specified encoding. + + A new encoder filter. + The name of the encoding to create a filter for. + The maximum number of octets allowed per line (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + + + is null. + + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Reset the filter. + + + Resets the filter. + + + + + An interface for incrementally filtering data. + + + An interface for incrementally filtering data. + + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The number of bytes of the input to filter. + The starting index of the output in the returned buffer. + The length of the output buffer. + + + + Filter the specified input, flushing all internally buffered data to the output. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The number of bytes of the input to filter. + The starting index of the output in the returned buffer. + The length of the output buffer. + + + + Reset the filter. + + + Resets the filter. + + + + + A filter that munges lines beginning with "From " by stuffing a '>' into the beginning of the line. + + + Munging Mbox-style "From "-lines is a workaround to prevent Mbox parsers from misinterpreting a + line beginning with "From " as an mbox marker delineating messages. This munging is non-reversable but + is necessary to properly format a message for saving to an Mbox file. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Reset the filter. + + + Resets the filter. + + + + + A base implementation for MIME filters. + + + A base implementation for MIME filters. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Get the output buffer. + + + Gets the output buffer. + + The output buffer. + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The number of bytes of the input to filter. + The starting index of the output in the returned buffer. + The length of the output buffer. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Filter the specified input, flushing all internally buffered data to the output. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The number of bytes of the input to filter. + The starting index of the output in the returned buffer. + The length of the output buffer. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Reset the filter. + + + Resets the filter. + + + + + Save the remaining input for the next round of processing. + + + Saves the remaining input for the next round of processing. + + The input buffer. + The starting index of the buffer to save. + The length of the buffer to save, starting at . + + + + Ensure that the output buffer is greater than or equal to the specified size. + + + Ensures that the output buffer is greater than or equal to the specified size. + + The minimum size needed. + If set to true, the current output should be preserved. + + + + A filter that simply passes data through without any processing. + + + Passes data through without any processing. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The number of bytes of the input to filter. + The starting index of the output in the returned buffer. + The length of the output buffer. + + + + Filter the specified input, flushing all internally buffered data to the output. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The number of bytes of the input to filter. + The starting index of the output in the returned buffer. + The length of the output buffer. + + + + Reset the filter. + + + Resets the filter. + + + + + A filter for stripping trailing whitespace from lines in a textual stream. + + + Strips trailing whitespace from lines in a textual stream. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Reset the filter. + + + Resets the filter. + + + + + A filter that will convert from Unix line endings to Windows/DOS line endings. + + + Converts from Unix line endings to Windows/DOS line endings. + + + + + Initialize a new instance of the class. + + + Creates a new . + + Ensure that the stream ends with a new line. + + + + Filter the specified input. + + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + + The filtered output. + The input buffer. + The starting index of the input buffer. + The length of the input buffer, starting at . + The output index. + The output length. + If set to true, all internally buffered data should be flushed to the output buffer. + + + + Reset the filter. + + + Resets the filter. + + + + + An interface allowing for a cancellable stream reading operation. + + + This interface is meant to extend the functionality of a , + allowing the to have much finer-grained canellability. + When a custom stream implementation also implements this interface, + the will opt to use this interface + instead of the normal + API to read data from the stream. + This is really useful when parsing a message or other MIME entity + directly from a network-based stream. + + + + + Read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + When a custom stream implementation also implements this interface, + the will opt to use this interface + instead of the normal + API to read data from the stream. + This is really useful when parsing a message or other MIME entity + directly from a network-based stream. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many + bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + The cancellation token. + + + + Write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + When a custom stream implementation also implements this interface, + writing a or + to the custom stream will opt to use this interface + instead of the normal + API to write data to the stream. + This is really useful when writing a message or other MIME entity + directly to a network-based stream. + + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + The cancellation token + + + + Clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + Clears all buffers for this stream and causes any buffered data to be written + to the underlying device. + + The cancellation token. + + + + A stream useful for measuring the amount of data written. + + + A keeps track of the number of bytes + that have been written to it. This is useful, for example, when you + need to know how large a is without + actually writing it to disk or into a memory buffer. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Check whether or not the stream supports reading. + + + A is not readable. + + true if the stream supports reading; otherwise, false. + + + + Check whether or not the stream supports writing. + + + A is always writable. + + true if the stream supports writing; otherwise, false. + + + + Check whether or not the stream supports seeking. + + + A is always seekable. + + true if the stream supports seeking; otherwise, false. + + + + Check whether or not reading and writing to the stream can timeout. + + + Writing to a cannot timeout. + + true if reading and writing to the stream can timeout; otherwise, false. + + + + Get the length of the stream, in bytes. + + + The length of a indicates the + number of bytes that have been written to it. + + The length of the stream in bytes. + + The stream has been disposed. + + + + + Get or set the current position within the stream. + + + Since it is possible to seek within a , + it is possible that the position will not always be identical to the + length of the stream, but typically it will be. + + The position of the stream. + + An I/O error occurred. + + + The stream does not support seeking. + + + The stream has been disposed. + + + + + Read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reading from a is not supported. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if + that many bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + + The stream has been disposed. + + + The stream does not support reading. + + + + + Asynchronously read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reading from a is not supported. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if + that many bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + The cancellation token. + + The stream has been disposed. + + + The stream does not support reading. + + + + + Write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Increments the property by the number of bytes written. + If the updated position is greater than the current length of the stream, then + the property will be updated to be identical to the + position. + + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Asynchronously write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Increments the property by the number of bytes written. + If the updated position is greater than the current length of the stream, then + the property will be updated to be identical to the + position. + + A task that represents the asynchronous write operation. + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + The cancellation token. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Set the position within the current stream. + + + Updates the within the stream. + + The new position within the stream. + The offset into the stream relative to the . + The origin to seek from. + + is not a valid . + + + The stream has been disposed. + + + + + Clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + Since a does not actually do anything other than + count bytes, this method is a no-op. + + + The stream has been disposed. + + + + + Asynchronously clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + Since a does not actually do anything other than + count bytes, this method is a no-op. + + A task that represents the asynchronous flush operation. + The cancellation token. + + The stream has been disposed. + + + + + Set the length of the stream. + + + Sets the to the specified value and updates + to the specified value if (and only if) + the current position is greater than the new length value. + + The desired length of the stream in bytes. + + is out of range. + + + The stream has been disposed. + + + + + Release the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + An efficient memory stream implementation that sacrifices the ability to + get access to the internal byte buffer in order to drastically improve + performance. + + + Instead of resizing an internal byte array, the + chains blocks of non-contiguous memory. This helps improve performance by avoiding + unneeded copying of data from the old array to the newly allocated array as well + as the zeroing of the newly allocated array. + + + + + Initialize a new instance of the class. + + + Creates a new with an initial memory block + of 2048 bytes. + + + + + Copy the memory stream into a byte array. + + + Copies all of the stream data into a newly allocated byte array. + + The array. + + + + Check whether or not the stream supports reading. + + + The is always readable. + + true if the stream supports reading; otherwise, false. + + + + Check whether or not the stream supports writing. + + + The is always writable. + + true if the stream supports writing; otherwise, false. + + + + Check whether or not the stream supports seeking. + + + The is always seekable. + + true if the stream supports seeking; otherwise, false. + + + + Check whether or not reading and writing to the stream can timeout. + + + The does not support timing out. + + true if reading and writing to the stream can timeout; otherwise, false. + + + + Get the length of the stream, in bytes. + + + Gets the length of the stream, in bytes. + + The length of the stream, in bytes. + + The stream has been disposed. + + + + + Get or set the current position within the stream. + + + Gets or sets the current position within the stream. + + The position of the stream. + + An I/O error occurred. + + + The stream does not support seeking. + + + The stream has been disposed. + + + + + Read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reads a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if + that many bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + An I/O error occurred. + + + + + Asynchronously read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reads a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if + that many bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + The cancellation token. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + An I/O error occurred. + + + + + Write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Writes the entire buffer to the stream and advances the current position + within the stream by the number of bytes written, adding memory blocks as + needed in order to contain the newly written bytes. + + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Asynchronously write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + Writes the entire buffer to the stream and advances the current position + within the stream by the number of bytes written, adding memory blocks as + needed in order to contain the newly written bytes. + + A task that represents the asynchronous write operation. + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + The cancellation token. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + The stream does not support writing. + + + An I/O error occurred. + + + + + Set the position within the current stream. + + + Sets the position within the current stream. + + The new position within the stream. + The offset into the stream relative to the . + The origin to seek from. + + is not a valid . + + + The stream has been disposed. + + + An I/O error occurred. + + + + + Clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + This method does not do anything. + + + The stream has been disposed. + + + + + Asynchronously clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + This method does not do anything. + + A task that represents the asynchronous flush operation. + The cancellation token. + + The stream has been disposed. + + + + + Set the length of the stream. + + + Sets the length of the stream. + + The desired length of the stream in bytes. + + is out of range. + + + The stream has been disposed. + + + + + Release the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + An interface for a textual MIME part. + + + Unless overridden, all textual parts parsed by the , + such as text/plain or text/html, will be represented by a . + For more information about text media types, see section 4.1 of + rfc2046. + + + + + + + + Get the text format of the content. + + + Gets the text format of the content. + + The text format of the content. + + The has been disposed. + + + + + Get whether or not this text part contains enriched text. + + + Checks whether or not the text part's Content-Type is text/enriched or its + predecessor, text/richtext (not to be confused with text/rtf). + + true if the text is enriched; otherwise, false. + + The has been disposed. + + + + + Get whether or not this text part contains flowed text. + + + Checks whether or not the text part's Content-Type is text/plain and + has a format parameter with a value of flowed. + + + + + true if the text is flowed; otherwise, false. + + The has been disposed. + + + + + Get whether or not this text part contains HTML. + + + Checks whether or not the text part's Content-Type is text/html. + + + + + true if the text is html; otherwise, false. + + The has been disposed. + + + + + Get whether or not this text part contains plain text. + + + Checks whether or not the text part's Content-Type is text/plain. + + true if the text is html; otherwise, false. + + The has been disposed. + + + + + Get whether or not this text part contains RTF. + + + Checks whether or not the text part's Content-Type is text/rtf. + + true if the text is RTF; otherwise, false. + + The has been disposed. + + + + + Get the decoded text content. + + + If the charset parameter on the + is set, it will be used in order to convert the raw content into unicode. + If that fails or if the charset parameter is not set, the first 2 bytes of + the content will be checked for a unicode BOM. If a BOM exists, then that + will be used for conversion. If no BOM is found, then UTF-8 is attempted. + If conversion fails, then iso-8859-1 will be used as the final fallback. + For more control, use + or . + + The decocded text. + + The has been disposed. + + + + + Try to detect the encoding of the text content. + + + Attempts to detect the encoding of the text content. + If no content is defined, then is set to ASCII and + is set to . + If a charset is specified on the Content-Type header and it is a supported encoding, then + is set to the encoding for the specified charset and + is set to . + If a Byte-Order-Mark (BOM) is found, then is set to the corresponding unicode + encoding and is set to . + If the content is in HTML format, then the first 1024 bytes are processed for <meta> tags + containing charset information. If charset information is found and the charset is a supported encoding, then + is set to the encoding for the specified charset and is + set to . + + true if an encoding was detected; otherwise, false. + The detected encoding; otherwise, null. + The confidence in the detected encoding being correct. + + The has been disposed. + + + + + Get the decoded text and the encoding used to convert it into unicode. + + + If the charset parameter on the + is set, it will be used in order to convert the raw content into unicode. + If that fails or if the charset parameter is not set, the first 3 bytes of + the content will be checked for a unicode BOM. If a BOM exists, then that + will be used for conversion. If no BOM is found, then UTF-8 is attempted. + If conversion fails, then iso-8859-1 will be used as the final fallback. + For more control, use + or . + + The encoding used to convert the text into unicode. + The decoded text. + + The has been disposed. + + + + + Get the decoded text content using the provided charset encoding to + override the charset specified in the Content-Type parameters. + + + Uses the provided charset encoding to convert the raw text content + into a unicode string, overriding any charset specified in the + Content-Type header. + + The decoded text. + The charset encoding to use. + + is null. + + + The has been disposed. + + + + + Get the decoded text content using the provided charset to override + the charset specified in the Content-Type parameters. + + + Uses the provided charset encoding to convert the raw text content + into a unicode string, overriding any charset specified in the + Content-Type header. + + The decoded text. + The charset encoding to use. + + is null. + + + The is not supported. + + + The has been disposed. + + + + + Set the text content and the charset parameter in the Content-Type header. + + + This method is similar to setting the property, + but allows specifying a charset encoding to use. Also updates the + property. + + The charset encoding. + The text content. + + is null. + -or- + is null. + + + The has been disposed. + + + + + Set the text content and the charset parameter in the Content-Type header. + + + This method is similar to setting the property, + but allows specifying a charset encoding to use. Also updates the + property. + + The charset encoding. + The text content. + + is null. + -or- + is null. + + + The is not supported. + + + The has been disposed. + + + + + An interface for a MIME part containing message headers as its content. + + + Represents MIME entities with a Content-Type of text/rfc822-headers. + + + + + A mailbox address, as specified by rfc822. + + + Represents a mailbox address (commonly referred to as an email address) + for a single recipient. + + + + + Get or set the punycode implementation that should be used for encoding and decoding mailbox addresses. + + + Gets or sets the punycode implementation that should be used for encoding and decoding mailbox addresses. + + The punycode implementation. + + + + Initialize a new instance of the class. + + + Creates a new with the specified name, address and route. The + specified text encoding is used when encoding the name according to the rules of rfc2047. + + The character encoding to be used for encoding the name. + The name of the mailbox. + The route of the mailbox. + The address of the mailbox. + + is null. + -or- + is null. + -or- + is null. + + + is malformed. + + + + + Initialize a new instance of the class. + + + Creates a new with the specified name, address and route. + + The name of the mailbox. + The route of the mailbox. + The address of the mailbox. + + is null. + -or- + is null. + + + is malformed. + + + + + Initialize a new instance of the class. + + + Creates a new with the specified name and address. The + specified text encoding is used when encoding the name according to the rules of rfc2047. + + The character encoding to be used for encoding the name. + The name of the mailbox. + The address of the mailbox. + + is null. + -or- + is null. + + + is malformed. + + + + + Initialize a new instance of the class. + + + Creates a new with the specified name and address. + + The name of the mailbox. + The address of the mailbox. + + is null. + + + is malformed. + + + + + Clone the mailbox address. + + + Clones the mailbox address. + + The cloned mailbox address. + + + + Get the mailbox route. + + + A route is convention that is rarely seen in modern email systems, but is supported + for compatibility with email archives. + + The mailbox route. + + + + Get or set the mailbox address. + + + Represents the actual email address and is in the form of user@domain.com. + + The mailbox address. + + is null. + + + is malformed. + + + + + Get the local-part of the email address. + + + Gets the local-part of the email address, sometimes referred to as the "user" portion of an email address. + + The local-part portion of the mailbox address. + + + + Get the domain of the email address. + + + Gets the domain of the email address. + + The domain portion of the mailbox address. + + + + Get whether or not the address is an international address. + + + International addresses are addresses that contain international + characters in either their local-parts or their domains. + For more information, see section 3.2 of + rfc6532. + + true if the address is an international address; otherwise, false. + + + + Encode an addrspec token according to IDN encoding rules. + + + Encodes an addrspec token according to IDN encoding rules. + + The encoded addrspec token. + The addrspec token. + + is null. + + + + + Decode an addrspec token according to IDN decoding rules. + + + Decodes an addrspec token according to IDN decoding rules. + + The decoded addrspec token. + The addrspec token. + + is null. + + + + + Get the mailbox address, optionally encoded according to IDN encoding rules. + + + If is true, then the returned mailbox address will be encoded according to the IDN encoding rules. + + true if the address should be encoded according to IDN encoding rules; otherwise, false. + The mailbox address. + + + + Return a string representation of the , + optionally encoding it for transport. + + + Returns a string containing the formatted mailbox address. If the + parameter is true, then the mailbox name will be encoded according to the rules defined + in rfc2047, otherwise the name will not be encoded at all and will therefor only be suitable + for display purposes. + + A string representing the . + The formatting options. + If set to true, the will be encoded. + + is null. + + + + + Determine whether the specified is equal to the current . + + + Compares two mailbox addresses to determine if they are identical or not. + + The to compare with the current . + true if the specified is equal to the current + ; otherwise, false. + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed mailbox address. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed mailbox address. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The starting index of the input buffer. + The parsed mailbox address. + + is null. + -or- + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The parsed mailbox address. + + is null. + + + is out of range. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The input buffer. + The parsed mailbox address. + + is null. + -or- + is null. + + + + + Try to parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The input buffer. + The parsed mailbox address. + + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The parser options to use. + The text. + The parsed mailbox address. + + is null. + + + + + Try to parse the given text into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + true, if the address was successfully parsed, false otherwise. + The text. + The parsed mailbox address. + + is null. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + The parsed . + The parser options to use. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + The parsed . + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + + is null. + + + and do not specify + a valid range in the byte array. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + The parsed . + The parser options to use. + The input buffer. + The starting index of the input buffer. + + is null. + -or- + is null. + + + is out of range. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + The parsed . + The input buffer. + The starting index of the input buffer. + + is null. + + + is out of range. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + The parsed . + The parser options to use. + The input buffer. + + is null. + -or- + is null. + + + could not be parsed. + + + + + Parse the given input buffer into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + The parsed . + The input buffer. + + is null. + + + could not be parsed. + + + + + Parse the given text into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + The parsed . + The parser options to use. + The text. + + is null. + -or- + is null. + + + could not be parsed. + + + + + Parse the given text into a new instance. + + + Parses a single . If the address is not a mailbox address or + there is more than a single mailbox address, then parsing will fail. + + The parsed . + The text. + + is null. + + + could not be parsed. + + + + + Explicit cast to convert a to a + . + + + Casts a to a + in cases where you might want to make use of the System.Net.Mail APIs. + + The equivalent . + The mailbox. + + + + Explicit cast to convert a + to a . + + + Casts a to a + in cases where you might want to make use of the the superior MimeKit APIs. + + The equivalent . + The mail address. + + + + A message delivery status MIME part. + + + A message delivery status MIME part is a machine readable notification denoting the + delivery status of a message and has a MIME-type of message/delivery-status. + For more information, see rfc3464. + + + + + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Get the groups of delivery status fields. + + + Gets the groups of delivery status fields. The first + contains the per-message fields while each remaining contains + fields that pertain to particular recipients of the message. + For more information about these fields and their values, check out + rfc3464. + Section 2.2 defines + the per-message fields while + Section 2.3 defines + the per-recipient fields. + + + + + The fields. + + The has been disposed. + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + A message disposition notification MIME part. + + + A message disposition notification MIME part is a machine readable notification + denoting the disposition of a message once it has been successfully delivered + and has a MIME-type of message/disposition-notification. + + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Get the disposition notification fields. + + + Gets the disposition notification fields. + + The disposition notification fields. + + The has been disposed. + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + A message feedback report MIME part. + + + A message/feedback-report MIME part is a machine readable feedback report. + + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Get the feedback report fields. + + + Gets the feedback report fields. + + The feedback report fields. + + The has been disposed. + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + A list of Message-Ids. + + + Used by the property. + + + + + Initialize a new instance of the class. + + + Creates a new, empty, . + + + + + Clone the . + + + Creates an exact copy of the . + + An exact copy of the . + + + + Get the index of the requested Message-Id, if it exists. + + + Finds the index of the specified Message-Id, if it exists. + + The index of the requested Message-Id; otherwise -1. + The Message-Id. + + is null. + + + + + Insert a Message-Id at the specified index. + + + Inserts the Message-Id at the specified index in the list. + + The index to insert the Message-Id. + The Message-Id to insert. + + is null. + + + is out of range. + + + + + Remove the Message-Id at the specified index. + + + Removes the Message-Id at the specified index. + + The index. + + is out of range. + + + + + Get or set the Message-Id at the specified index. + + + Gets or sets the Message-Id at the specified index. + + The Message-Id at the specified index. + The index. + + is null. + + + is out of range. + + + + + Add a Message-Id. + + + Adds the specified Message-Id to the end of the list. + + The Message-Id. + + is null. + + + + + Add a collection of Message-Ids. + + + Adds a collection of Message-Id items to append to the list. + + The Message-Id items to add. + + is null. + + + + + Clear the Message-Id list. + + + Removes all of the Message-Ids in the list. + + + + + Check if the contains the specified Message-Id. + + + Determines whether or not the list contains the specified Message-Id. + + true if the specified Message-Id is contained; + otherwise false. + The Message-Id. + + is null. + + + + + Copy all of the Message-Ids in the to the specified array. + + + Copies all of the Message-Ids within the into the array, + starting at the specified array index. + + The array to copy the Message-Ids to. + The index into the array. + + is null. + + + is out of range. + + + + + Remove a Message-Id from the . + + + Removes the first instance of the specified Message-Id from the list if it exists. + + true if the specified Message-Id was removed; + otherwise false. + The Message-Id. + + is null. + + + + + Get the number of Message-Ids in the . + + + Indicates the number of Message-Ids in the list. + + The number of Message-Ids. + + + + Get a value indicating whether the is read only. + + + A is never read-only. + + true if this instance is read only; otherwise, false. + + + + Get an enumerator for the list of Message-Ids. + + + Gets an enumerator for the list of Message-Ids. + + The enumerator. + + + + Get an enumerator for the list of Message-Ids. + + + Gets an enumerator for the list of Message-Ids. + + The enumerator. + + + + Serialize a to a string. + + + Each Message-Id will be surrounded by angle brackets. + If there are multiple Message-Ids in the list, they will be separated by whitespace. + + A string representing the . + + + + An enumeration of message importance values. + + + Indicates the importance of a message. + + + + + The message is of low importance. + + + + + The message is of normal importance. + + + + + The message is of high importance. + + + + + A MIME part containing a as its content. + + + Represents MIME entities such as those with a Content-Type of message/rfc822 or message/news. + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The message subtype. + An array of initialization parameters: headers and message parts. + + is null. + -or- + is null. + + + contains more than one . + -or- + contains one or more arguments of an unknown type. + + + + + Initialize a new instance of the class. + + + Initializes the based on the provided media type and subtype. + + The media type. + The media subtype. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new MIME message entity with the specified subtype. + + The message subtype. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new message/rfc822 MIME entity. + + + + + Gets or sets the message content. + + + Gets or sets the message content. + + The message content. + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Prepare the MIME entity for transport using the specified encoding constraints. + + + Prepares the MIME entity for transport using the specified encoding constraints. + + The encoding constraint. + The maximum number of octets allowed per line (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + -or- + is not a valid value. + + + The has been disposed. + + + + + Write the to the output stream. + + + Writes the MIME entity and its message to the output stream. + + The formatting options. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the output stream. + + + Asynchronously writes the MIME entity and its message to the output stream. + + An awaitable task. + The formatting options. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Releases the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + A MIME part containing a partial message as its content. + + + The "message/partial" MIME-type is used to split large messages into + multiple parts, typically to work around transport systems that have size + limitations (for example, some SMTP servers limit have a maximum message + size that they will accept). + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new message/partial entity. + Three (3) parameters must be specified in the Content-Type header + of a message/partial: id, number, and total. + The "id" parameter is a unique identifier used to match the parts together. + The "number" parameter is the sequential (1-based) index of the partial message fragment. + The "total" parameter is the total number of pieces that make up the complete message. + + The id value shared among the partial message parts. + The (1-based) part number for this partial message part. + The total number of partial message parts. + + is null. + + + is less than 1. + -or- + is less than . + + + + + Get the "id" parameter of the Content-Type header. + + + The "id" parameter is a unique identifier used to match the parts together. + + The identifier. + + + + Get the "number" parameter of the Content-Type header. + + + The "number" parameter is the sequential (1-based) index of the partial message fragment. + + The part number. + + + + Get the "total" parameter of the Content-Type header. + + + The "total" parameter is the total number of pieces that make up the complete message. + + The total number of parts. + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Split a message into multiple messages. + + + Splits the specified message into multiple messages, each with a + message/partial body no larger than the max size specified. + + An enumeration of partial messages. + The message. + The maximum size for each message body. + + is null. + + + is less than 1. + + + has been disposed. + + + + + Join the specified message/partial parts into the complete message. + + + Combines all of the message/partial fragments into its original, + complete, message. + + The re-combined message. + The parser options to use. + The message that contains the first `message/partial` part. + The list of partial message parts. + + is null. + -or- + is null. + -or- + is null. + + + The last partial does not have a "total" parameter in the Content-Type header. + -or- + The number of partials provided does not match the expected count. + -or- + One or more partials is missing. + + + One or more has a mismatching id parameter in the Content-Type header. + -or- + One or more has a missing number parameter in the Content-Type header. + + + + + Join the specified message/partial parts into the complete message. + + + Combines all of the message/partial fragments into its original, + complete, message. + + The re-combined message. + The message that contains the first `message/partial` part. + The list of partial message parts. + + is null. + -or- + is null. + + + The last partial does not have a "total" parameter in the Content-Type header. + -or- + The number of partials provided does not match the expected count. + -or- + One or more partials is missing. + + + One or more has a mismatching id parameter in the Content-Type header. + -or- + One or more has a missing number parameter in the Content-Type header. + + + + + An enumeration of message priority values. + + + Indicates the priority of a message. + + + + + The message has non-urgent priority. + + + + + The message has normal priority. + + + + + The message has urgent priority. + + + + + Encapsulates a content stream used by . + + + A represents the content of a . + The content has both a stream and an encoding (typically ). + + + + + + + + Initialize a new instance of the class. + + + When creating new s, the + should typically be unless the + has already been encoded. + + The content stream. + The stream encoding. + + is null. + + + does not support reading. + -or- + does not support seeking. + + + + + Releases unmanaged resources and performs other cleanup operations before the + is reclaimed by garbage collection. + + + Releases unmanaged resources and performs other cleanup operations before the + is reclaimed by garbage collection. + + + + + Get or set the content encoding. + + + If the was parsed from an existing stream, the + encoding will be identical to the , + otherwise it will typically be . + + The content encoding. + + + + Get the new-line format, if known. + + + This property is typically only set by the as it parses + the content of a and is only used as a hint when verifying + digital signatures. + + The new-line format, if known. + + + + Get the content stream. + + + Gets the content stream. + + The stream. + + + + Open the decoded content stream. + + + Provides a means of reading the decoded content without having to first write it to another + stream using . + + The decoded content stream. + + The has been disposed. + + + + + Copy the content stream to the specified output stream. + + + This is equivalent to simply using + to copy the content stream to the output stream except that this method is cancellable. + If you want the decoded content, use + instead. + + The output stream. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously copy the content stream to the specified output stream. + + + This is equivalent to simply using + to copy the content stream to the output stream except that this method is cancellable. + If you want the decoded content, use + instead. + + An awaitable task. + The output stream. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Decode the content stream into another stream. + + + If the content stream is encoded, this method will decode it into the output stream + using a suitable decoder based on the property, otherwise the + stream will be copied into the output stream as-is. + + + + + The output stream. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously decode the content stream into another stream. + + + If the content stream is encoded, this method will decode it into the output stream + using a suitable decoder based on the property, otherwise the + stream will be copied into the output stream as-is. + + + + + An awaitable task. + The output stream. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Release the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + Release all resources used by the object. + + Call when you are finished using the . The + method leaves the in an unusable state. After + calling , you must release all references to the so + the garbage collector can reclaim the memory that the was occupying. + + + + An abstract MIME entity. + + + A MIME entity is really just a node in a tree structure of MIME parts in a MIME message. + There are 3 basic types of entities: , , + and (which is actually just a special variation of + who's content is another MIME message/document). All other types are + derivatives of one of those. + + + + + Initialize a new instance of the class + based on the . + + + Custom subclasses MUST implement this constructor + in order to register it using . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Initializes the based on the provided media type and subtype. + + The media type. + The media subtype. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Initializes the to the one provided. + + The content type. + + is null. + + + + + Releases unmanaged resources and performs other cleanup operations before the + is reclaimed by garbage collection. + + + Releases unmanaged resources and performs other cleanup operations before the + is reclaimed by garbage collection. + + + + + Tries to use the given object to initialize the appropriate property. + + + Initializes the appropriate property based on the type of the object. + + The object. + true if the object was recognized and used; false otherwise. + + + + Get the list of headers. + + + Represents the list of headers for a MIME part. Typically, the headers of + a MIME part will be various Content-* headers such as Content-Type or + Content-Disposition, but may include just about anything. + + The list of headers. + + + + Get or set the content disposition. + + + Represents the pre-parsed Content-Disposition header value, if present. + If the Content-Disposition header is not set, then this property will + be null. + + The content disposition. + + The has been disposed. + + + + + Get the type of the content. + + + The Content-Type header specifies information about the type of content contained + within the MIME entity. + + The type of the content. + + + + Get or set the base content URI. + + + The Content-Base header specifies the base URI for the + in cases where the is a relative URI. + The Content-Base URI must be an absolute URI. + For more information, see rfc2110. + + The base content URI or null. + + is not an absolute URI. + + + The has been disposed. + + + + + Get or set the content location. + + + The Content-Location header specifies the URI for a MIME entity and can be + either absolute or relative. + Setting a Content-Location URI allows other objects + within the same multipart/related container to reference this part by URI. This + can be useful, for example, when constructing an HTML message body that needs to + reference image attachments. + For more information, see rfc2110. + + The content location or null. + + The has been disposed. + + + + + Get or set the Content-Id. + + + The Content-Id header is used for uniquely identifying a particular entity and + uses the same syntax as the Message-Id header on MIME messages. + Setting a Content-Id allows other objects within the same + multipart/related container to reference this part by its unique identifier, typically + by using a "cid:" URI in an HTML-formatted message body. This can be useful, for example, + when the HTML-formatted message body needs to reference image attachments. + It is recommended that or + be used to generate a valid + Content-Id value. + + The content identifier. + + The has been disposed. + + + + + Get a value indicating whether this is an attachment. + + + If the Content-Disposition header is set and has a value of "attachment", + then this property returns true. Otherwise it is assumed that the + is not meant to be treated as an attachment. + + true if this is an attachment; otherwise, false. + + The has been disposed. + + + + + Return a that represents the for debugging purposes. + + + Returns a that represents the for debugging purposes. + In general, the string returned from this method SHOULD NOT be used for serializing + the entity to disk. It is recommended that you use instead. + If this method is used for serializing the entity to disk, the iso-8859-1 text encoding should be used for + conversion. + + A that represents the for debugging purposes. + + The has been disposed. + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Prepare the MIME entity for transport using the specified encoding constraints. + + + Prepares the MIME entity for transport using the specified encoding constraints. + + The encoding constraint. + The maximum allowable length for a line (not counting the CRLF). Must be between 72 and 998 (inclusive). + + is not between 72 and 998 (inclusive). + -or- + is not a valid value. + + + The has been disposed. + + + + + Write the to the specified output stream. + + + Writes the headers to the output stream, followed by a blank line. + Subclasses should override this method to write the content of the entity. + + The formatting options. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Asynchronously writes the headers to the output stream, followed by a blank line. + Subclasses should override this method to write the content of the entity. + + An awaitable task. + The formatting options. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the to the specified output stream. + + + Writes the headers to the output stream, followed by a blank line. + Subclasses should override this method to write the content of the entity. + + The formatting options. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Asynchronously writes the headers to the output stream, followed by a blank line. + Subclasses should override this method to write the content of the entity. + + An awaitable task. + The formatting options. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the to the specified output stream. + + + Writes the entity to the output stream. + + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Asynchronously writes the entity to the output stream. + + An awaitable task. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the to the specified output stream. + + + Writes the entity to the output stream. + + The output stream. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Asynchronously writes the entity to the output stream. + + An awaitable task. + The output stream. + The cancellation token. + + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the to the specified file. + + + Writes the entity to the specified file using the provided formatting options. + + The formatting options. + The file. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified file. + + + Asynchronously writes the entity to the specified file using the provided formatting options. + + An awaitable task. + The formatting options. + The file. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Write the to the specified file. + + + Writes the entity to the specified file using the provided formatting options. + + The formatting options. + The file. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified file. + + + Asynchronously writes the entity to the specified file using the provided formatting options. + + An awaitable task. + The formatting options. + The file. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Write the to the specified file. + + + Writes the entity to the specified file using the default formatting options. + + The file. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified file. + + + Asynchronously writes the entity to the specified file using the default formatting options. + + An awaitable task. + The file. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Write the to the specified file. + + + Writes the entity to the specified file using the default formatting options. + + The file. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified file. + + + Asynchronously writes the entity to the specified file using the default formatting options. + + An awaitable task. + The file. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Remove a header by name. + + + Removes all headers matching the specified name without + calling . + + The name of the header. + + + + Set the value of a header. + + + Sets the header to the specified value without + calling . + + The name of the header. + The value of the header. + + + + Set the value of a header using the raw value. + + + Sets the header to the specified value without + calling . + + The name of the header. + The raw value of the header. + + + + Called when the headers change in some way. + + + Whenever a header is added, changed, or removed, this method will + be called in order to allow custom subclasses + to update their state. + Overrides of this method should call the base method so that their + superclass may also update its own state. + + The type of change. + The header being added, changed or removed. + + + + Releases the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + Releases all resources used by the object. + + Call when you are finished using the . The + method leaves the in an unusable state. After + calling , you must release all references to the so + the garbage collector can reclaim the memory that the was occupying. + + + + Load a from the specified stream. + + + Loads a from the given stream, using the + specified . + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save mmeory usage, but also improve + performance. + + The parsed MIME entity. + The parser options. + The stream. + true if the stream is persistent; otherwise false. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified stream. + + + Loads a from the given stream, using the + specified . + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save mmeory usage, but also improve + performance. + + The parsed MIME entity. + The parser options. + The stream. + true if the stream is persistent; otherwise false. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified stream. + + + Loads a from the given stream, using the + specified . + + The parsed MIME entity. + The parser options. + The stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified stream. + + + Loads a from the given stream, using the + specified . + + The parsed MIME entity. + The parser options. + The stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified stream. + + + Loads a from the given stream, using the + default . + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save mmeory usage, but also improve + performance. + + The parsed MIME entity. + The stream. + true if the stream is persistent; otherwise false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified stream. + + + Loads a from the given stream, using the + default . + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + + The parsed MIME entity. + The stream. + true if the stream is persistent; otherwise false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified stream. + + + Loads a from the given stream, using the + default . + + The parsed MIME entity. + The stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified stream. + + + Loads a from the given stream, using the + default . + + The parsed MIME entity. + The stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified file. + + + Loads a from the file at the give file path, + using the specified . + + The parsed entity. + The parser options. + The name of the file to load. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified file. + + + Loads a from the file at the give file path, + using the specified . + + The parsed entity. + The parser options. + The name of the file to load. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified file. + + + Loads a from the file at the give file path, + using the default . + + The parsed entity. + The name of the file to load. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified file. + + + Loads a from the file at the give file path, + using the default . + + The parsed entity. + The name of the file to load. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified content stream. + + + This method is mostly meant for use with APIs such as + where the headers are parsed separately from the content. + + The parsed MIME entity. + The parser options. + The Content-Type of the stream. + The content stream. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified content stream. + + + This method is mostly meant for use with APIs such as + where the headers are parsed separately from the content. + + The parsed MIME entity. + The parser options. + The Content-Type of the stream. + The content stream. + The cancellation token. + + is null. + -or- + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified content stream. + + + This method is mostly meant for use with APIs such as + where the headers are parsed separately from the content. + + + + + The parsed MIME entity. + The Content-Type of the stream. + The content stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified content stream. + + + This method is mostly meant for use with APIs such as + where the headers are parsed separately from the content. + + The parsed MIME entity. + The Content-Type of the stream. + The content stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Event args emitted by the when it begins parsing a . + + + Event args emitted by the when it begins parsing a . + + + + + Initialize a new instance of the class. + + + Creates a new . + + The entity that is being parsed. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The entity that is being parsed. + The parent multipart. + + is null. + -or- + is null. + + + + + Get the MIME entity. + + + Gets the MIME entity. + + The MIME entity. + + + + Get the parent if this entity is a child. + + + Gets the parent if this entity is a child. + + The parent . + + + + Get or set the stream offset that marks the beginning of the entity. + + + Gets or sets the stream offset that marks the beginning of the entity. + + The stream offset. + + + + Get or set the line number of the beginning of the entity. + + + Gets or sets the line number of the beginning of the entity. + + The line number. + + + + MIME entity constructor arguments. + + + MIME entity constructor arguments. + + + + + Event args emitted by the when a is parsed. + + + Event args emitted by the when a is parsed. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The entity that was parsed. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The entity that was parsed. + The parent multipart. + + is null. + -or- + is null. + + + + + Get or set the stream offset that marks the end of the entity's headers. + + + Gets or sets the stream offset that marks the end of the entity's headers. + + The stream offset. + + + + Get or set the stream offset that marks the end of the entity. + + + Gets or sets the stream offset that marks the end of the entity. + + The stream offset. + + + + Get or set the content length of the entity as measured in lines. + + + Get or set the content length of the entity as measured in lines. + The line count reported by this property is the number of lines in its + content transfer encoding and not the resulting line count after any decoding. + + The length of the content in lines. + + + + The format of the MIME stream. + + + The format of the MIME stream. + + + + + The stream contains a single MIME entity or message. + + + + + The stream is in the Unix mbox format and may contain + more than a single message. + + + + + The default stream format. + + + + + An iterator for a MIME tree structure. + + + Walks the MIME tree structure of a in depth-first order. + + + + + + + + Initialize a new instance of the class. + + + Creates a new for the specified message. + + + + + The message. + + is null. + + + + + Releases unmanaged resources and performs other cleanup operations before + the is reclaimed by garbage collection. + + + Releases unmanaged resources and performs other cleanup operations before + the is reclaimed by garbage collection. + + + + + Get the top-level message. + + + Gets the top-level message. + + The message. + + + + Get the parent of the current entity. + + + After an iterator is created or after the method is called, + the method must be called to advance the iterator to the + first entity of the message before reading the value of the Parent property; + otherwise, Parent throws a . Parent + also throws a if the last call to + returned false, which indicates the end of the message. + If the current entity is the top-level entity of the message, then the parent + will be null; otherwise the parent will be either be a + or a . + + + + + The parent entity. + + Either has not been called or + has moved beyond the end of the message. + + + + + Get the current entity. + + + After an iterator is created or after the method is called, + the method must be called to advance the iterator to the + first entity of the message before reading the value of the Current property; + otherwise, Current throws a . Current + also throws a if the last call to + returned false, which indicates the end of the message. + + + + + The current entity. + + Either has not been called or + has moved beyond the end of the message. + + + + + Get the current entity. + + + After an iterator is created or after the method is called, + the method must be called to advance the iterator to the + first entity of the message before reading the value of the Current property; + otherwise, Current throws a . Current + also throws a if the last call to + returned false, which indicates the end of the message. + + The current entity. + + Either has not been called or + has moved beyond the end of the message. + + + + + Get the path specifier for the current entity. + + + After an iterator is created or after the method is called, + the method must be called to advance the iterator to the + first entity of the message before reading the value of the PathSpecifier property; + otherwise, PathSpecifier throws a . + PathSpecifier also throws a if the + last call to returned false, which indicates the end of + the message. + + The path specifier. + + Either has not been called or + has moved beyond the end of the message. + + + + + Get the depth of the current entity. + + + After an iterator is created or after the method is called, + the method must be called to advance the iterator to the + first entity of the message before reading the value of the Depth property; + otherwise, Depth throws a . Depth + also throws a if the last call to + returned false, which indicates the end of the message. + + The depth. + + Either has not been called or + has moved beyond the end of the message. + + + + + Advance the iterator to the next depth-first entity of the tree structure. + + + After an iterator is created or after the method is called, + an iterator is positioned before the first entity of the message, and the first + call to the MoveNext method moves the iterator to the first entity of the message. + If MoveNext advances beyond the last entity of the message, MoveNext returns false. + When the iterator is at this position, subsequent calls to MoveNext also return + false until is called. + + + + + true if the iterator was successfully advanced to the next entity; otherwise, false. + + + + Advance to the entity specified by the path specifier. + + + Advances the iterator to the entity specified by the path specifier which + must be in the same format as returned by . + If the iterator has already advanced beyond the entity at the specified + path, the iterator will and advance as normal. + + true if advancing to the specified entity was successful; otherwise, false. + The path specifier. + + is null. + + + is empty. + + + is in an invalid format. + + + + + Reset the iterator to its initial state. + + + Resets the iterator to its initial state. + + + + + Release the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + Release all resources used by the object. + + Call when you are finished using the . The + method leaves the in an unusable state. After + calling , you must release all references to the so + the garbage collector can reclaim the memory that the was occupying. + + + + A MIME message. + + + A message consists of header fields and, optionally, a body. + The body of the message can either be plain text or it can be a + tree of MIME entities such as a text/plain MIME part and a collection + of file attachments. + + + + + Initialize a new instance of the class. + + + Creates a new . + + An array of initialization parameters: headers and message parts. + + is null. + + + contains more than one . + -or- + contains one or more arguments of an unknown type. + + + + + Initialize a new instance of the class. + + + Creates a new MIME message, specifying details at creation time. + + The list of addresses in the From header. + The list of addresses in the To header. + The subject of the message. + The body of the message. + + + + Initialize a new instance of the class. + + + Creates a new MIME message. + + + + + Releases unmanaged resources and performs other cleanup operations before the + is reclaimed by garbage collection. + + + Releases unmanaged resources and performs other cleanup operations before the + is reclaimed by garbage collection. + + + + + Get or set the mbox marker. + + + Set by the when parsing attached message/rfc822 parts + so that the message/rfc822 part can be reserialized back to its original form. + + The mbox marker. + + + + Get the list of headers. + + + Represents the list of headers for a message. Typically, the headers of + a message will contain transmission headers such as From and To along + with metadata headers such as Subject and Date, but may include just + about anything. + To access any MIME headers such as , + , + or any other Content-* header, you will need to access the + property of the . + + + The list of headers. + + + + Get or set the value of the Importance header. + + + Gets or sets the value of the Importance header. + + The importance. + + is not a valid . + + + + + Get or set the value of the Priority header. + + + Gets or sets the value of the Priority header. + + The priority. + + is not a valid . + + + + + Get or set the value of the X-Priority header. + + + Gets or sets the value of the X-Priority header. + + The priority. + + is not a valid . + + + + + Get or set the address in the Sender header. + + + The sender may differ from the addresses in if + the message was sent by someone on behalf of someone else. + + The address in the Sender header. + + + + Get or set the address in the Resent-Sender header. + + + The resent sender may differ from the addresses in if + the message was sent by someone on behalf of someone else. + + The address in the Resent-Sender header. + + + + Get the list of addresses in the From header. + + + The "From" header specifies the author(s) of the message. + If more than one is added to the + list of "From" addresses, the should be set to the + single of the personal actually sending + the message. + + The list of addresses in the From header. + + + + Get the list of addresses in the Resent-From header. + + + The "Resent-From" header specifies the author(s) of the messagebeing + resent. + If more than one is added to the + list of "Resent-From" addresses, the should + be set to the single of the personal actually + sending the message. + + The list of addresses in the Resent-From header. + + + + Get the list of addresses in the Reply-To header. + + + When the list of addresses in the Reply-To header is not empty, + it contains the address(es) where the author(s) of the message prefer + that replies be sent. + When the list of addresses in the Reply-To header is empty, + replies should be sent to the mailbox(es) specified in the From + header. + + The list of addresses in the Reply-To header. + + + + Get the list of addresses in the Resent-Reply-To header. + + + When the list of addresses in the Resent-Reply-To header is not empty, + it contains the address(es) where the author(s) of the resent message prefer + that replies be sent. + When the list of addresses in the Resent-Reply-To header is empty, + replies should be sent to the mailbox(es) specified in the Resent-From + header. + + The list of addresses in the Resent-Reply-To header. + + + + Get the list of addresses in the To header. + + + The addresses in the To header are the primary recipients of + the message. + + The list of addresses in the To header. + + + + Get the list of addresses in the Resent-To header. + + + The addresses in the Resent-To header are the primary recipients of + the message. + + The list of addresses in the Resent-To header. + + + + Get the list of addresses in the Cc header. + + + The addresses in the Cc header are secondary recipients of the message + and are usually not the individuals being directly addressed in the + content of the message. + + The list of addresses in the Cc header. + + + + Get the list of addresses in the Resent-Cc header. + + + The addresses in the Resent-Cc header are secondary recipients of the message + and are usually not the individuals being directly addressed in the + content of the message. + + The list of addresses in the Resent-Cc header. + + + + Get the list of addresses in the Bcc header. + + + Recipients in the Blind-Carbon-Copy list will not be visible to + the other recipients of the message. + + The list of addresses in the Bcc header. + + + + Get the list of addresses in the Resent-Bcc header. + + + Recipients in the Resent-Bcc list will not be visible to + the other recipients of the message. + + The list of addresses in the Resent-Bcc header. + + + + Get or set the subject of the message. + + + The Subject is typically a short string denoting the topic of the message. + Replies will often use "Re: " followed by the Subject of the original message. + + The subject of the message. + + is null. + + + + + Get or set the date of the message. + + + If the date is not explicitly set before the message is written to a stream, + the date will default to the exact moment when it is written to said stream. + + The date of the message. + + + + Get or set the Resent-Date of the message. + + + Gets or sets the Resent-Date of the message. + + The Resent-Date of the message. + + + + Get the list of references to other messages. + + + The References header contains a chain of Message-Ids back to the + original message that started the thread. + + The references. + + + + Get or set the Message-Id that this message is replying to. + + + If the message is a reply to another message, it will typically + use the In-Reply-To header to specify the Message-Id of the + original message being replied to. + + The message id that this message is in reply to. + + is improperly formatted. + + + + + Get or set the message identifier. + + + The Message-Id is meant to be a globally unique identifier for + a message. + can be used + to generate this value. + + The message identifier. + + is null. + + + is improperly formatted. + + + + + Get or set the Resent-Message-Id header. + + + The Resent-Message-Id is meant to be a globally unique identifier for + a message. + can be used + to generate this value. + + The Resent-Message-Id. + + is null. + + + is improperly formatted. + + + + + Get or set the MIME-Version. + + + The MIME-Version header specifies the version of the MIME specification + that the message was created for. + + The MIME version. + + is null. + + + + + Get or set the body of the message. + + + The body of the message can either be plain text or it can be a + tree of MIME entities such as a text/plain MIME part and a collection + of file attachments. + For a convenient way of constructing message bodies, see the + class. + + The body of the message. + + + + Get the text body of the message if it exists. + + + Gets the text content of the first text/plain body part that is found (in depth-first + search order) which is not an attachment. + + The text body if it exists; otherwise, null. + + + + Get the html body of the message if it exists. + + + Gets the HTML-formatted body of the message if it exists. + + The html body if it exists; otherwise, null. + + + + Get the text body in the specified format. + + + Gets the text body in the specified format, if it exists. + + The text body in the desired format if it exists; otherwise, null. + The desired text format. + + + + Get the body parts of the message. + + + Traverses over the MIME tree, enumerating all of the objects, + but does not traverse into the bodies of attached messages. + + + + + The body parts. + + + + Get the attachments. + + + Traverses over the MIME tree, enumerating all of the objects that + have a Content-Disposition header set to "attachment". + + + + + The attachments. + + + + Get the concatenated list of recipients. + + + Gets the concatenated list of recipients. + If the Resent-Sender or Resent-From headers exist, then the recipients defined by the Resent-To, + Resent-Cc and Resent-Bcc headers will be used. Otherwise, the recipients defined by the To, Cc + and Bcc headers will be used. + + If true, only mailboxes with a unique address will be included. + The concatenated list of recipients. + + + + Returns a that represents the for debugging purposes. + + + Returns a that represents the for debugging purposes. + In general, the string returned from this method SHOULD NOT be used for serializing + the message to disk. It is recommended that you use instead. + If this method is used for serializing the message to disk, the iso-8859-1 text encoding should be used for + conversion. + + A that represents the for debugging purposes. + + + + Dispatches to the specific visit method for this MIME message. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + + + Prepare the message for transport using the specified encoding constraints. + + + Prepares the message for transport using the specified encoding constraints. + + The encoding constraint. + The maximum allowable length for a line (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + -or- + is not a valid value. + + + + + Write the message to the specified output stream. + + + Writes the message to the output stream using the provided formatting options. + + The formatting options. + The output stream. + true if only the headers should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified output stream. + + + Asynchronously writes the message to the output stream using the provided formatting options. + + An awaitable task. + The formatting options. + The output stream. + true if only the headers should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the message to the specified output stream. + + + Writes the message to the output stream using the provided formatting options. + + The formatting options. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified output stream. + + + Asynchronously writes the message to the output stream using the provided formatting options. + + An awaitable task. + The formatting options. + The output stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the message to the specified output stream. + + + Writes the message to the output stream using the default formatting options. + + The output stream. + true if only the headers should be written; otherwise, false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified output stream. + + + Asynchronously writes the message to the output stream using the default formatting options. + + An awaitable task. + The output stream. + true if only the headers should be written; otherwise, false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the message to the specified output stream. + + + Writes the message to the output stream using the default formatting options. + + The output stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified output stream. + + + Asynchronously writes the message to the output stream using the default formatting options. + + An awaitable task. + The output stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Write the message to the specified file. + + + Writes the message to the specified file using the provided formatting options. + + The formatting options. + The file. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified file. + + + Asynchronously writes the message to the specified file using the provided formatting options. + + An awaitable task. + The formatting options. + The file. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Write the message to the specified file. + + + Writes the message to the specified file using the default formatting options. + + The file. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Asynchronously write the message to the specified file. + + + Asynchronously writes the message to the specified file using the default formatting options. + + An awaitable task. + The file. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + The operation was canceled via the cancellation token. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to write to the specified file. + + + An I/O error occurred. + + + + + Sign the message using the specified cryptography context and digest algorithm. + + + If either of the Resent-Sender or Resent-From headers are set, then the message + will be signed using the Resent-Sender (or first mailbox in the Resent-From) + address as the signer address, otherwise the Sender or From address will be + used instead. + + The cryptography context. + The digest algorithm. + The cancellation token. + + is null. + + + The has not been set. + -or- + A sender has not been specified. + + + The was out of range. + + + The is not supported. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for the sender. + + + The private key could not be found for the sender. + + + + + Asynchronously sign the message using the specified cryptography context and digest algorithm. + + + If either of the Resent-Sender or Resent-From headers are set, then the message + will be signed using the Resent-Sender (or first mailbox in the Resent-From) + address as the signer address, otherwise the Sender or From address will be + used instead. + + An asynchronous task context. + The cryptography context. + The digest algorithm. + The cancellation token. + + is null. + + + The has not been set. + -or- + A sender has not been specified. + + + The was out of range. + + + The is not supported. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for the sender. + + + The private key could not be found for the sender. + + + + + Sign the message using the specified cryptography context and the SHA-1 digest algorithm. + + + If either of the Resent-Sender or Resent-From headers are set, then the message + will be signed using the Resent-Sender (or first mailbox in the Resent-From) + address as the signer address, otherwise the Sender or From address will be + used instead. + + The cryptography context. + The cancellation token. + + is null. + + + The has not been set. + -or- + A sender has not been specified. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for the sender. + + + The private key could not be found for the sender. + + + + + Asynchronously sign the message using the specified cryptography context and the SHA-1 digest algorithm. + + + If either of the Resent-Sender or Resent-From headers are set, then the message + will be signed using the Resent-Sender (or first mailbox in the Resent-From) + address as the signer address, otherwise the Sender or From address will be + used instead. + + An asynchronous task context. + The cryptography context. + The cancellation token. + + is null. + + + The has not been set. + -or- + A sender has not been specified. + + + The operation was canceled via the cancellation token. + + + A signing certificate could not be found for the sender. + + + The private key could not be found for the sender. + + + + + Encrypt the message to the sender and all of the recipients + using the specified cryptography context. + + + If either of the Resent-Sender or Resent-From headers are set, then the message + will be encrypted to all of the addresses specified in the Resent headers + (Resent-Sender, Resent-From, Resent-To, Resent-Cc, and Resent-Bcc), + otherwise the message will be encrypted to all of the addresses specified in + the standard address headers (Sender, From, To, Cc, and Bcc). + + The cryptography context. + The cancellation token. + + is null. + + + An unknown type of cryptography context was used. + + + The has not been set. + -or- + No recipients have been specified. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the recipients. + + + The public key could not be found for one or more of the recipients. + + + + + Asynchronously encrypt the message to the sender and all of the recipients + using the specified cryptography context. + + + If either of the Resent-Sender or Resent-From headers are set, then the message + will be encrypted to all of the addresses specified in the Resent headers + (Resent-Sender, Resent-From, Resent-To, Resent-Cc, and Resent-Bcc), + otherwise the message will be encrypted to all of the addresses specified in + the standard address headers (Sender, From, To, Cc, and Bcc). + + An asynchronous task context. + The cryptography context. + The cancellation token. + + is null. + + + An unknown type of cryptography context was used. + + + The has not been set. + -or- + No recipients have been specified. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for one or more of the recipients. + + + The public key could not be found for one or more of the recipients. + + + + + Sign and encrypt the message to the sender and all of the recipients using + the specified cryptography context and the specified digest algorithm. + + + If either of the Resent-Sender or Resent-From headers are set, then the message + will be signed using the Resent-Sender (or first mailbox in the Resent-From) + address as the signer address, otherwise the Sender or From address will be + used instead. + Likewise, if either of the Resent-Sender or Resent-From headers are set, then the + message will be encrypted to all of the addresses specified in the Resent headers + (Resent-Sender, Resent-From, Resent-To, Resent-Cc, and Resent-Bcc), + otherwise the message will be encrypted to all of the addresses specified in + the standard address headers (Sender, From, To, Cc, and Bcc). + + The cryptography context. + The digest algorithm. + The cancellation token. + + is null. + + + An unknown type of cryptography context was used. + + + The was out of range. + + + The has not been set. + -or- + No sender has been specified. + -or- + No recipients have been specified. + + + The is not supported. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for the signer or one or more of the recipients. + + + The private key could not be found for the sender. + + + The public key could not be found for one or more of the recipients. + + + + + Asynchronously sign and encrypt the message to the sender and all of the recipients using + the specified cryptography context and the specified digest algorithm. + + + If either of the Resent-Sender or Resent-From headers are set, then the message + will be signed using the Resent-Sender (or first mailbox in the Resent-From) + address as the signer address, otherwise the Sender or From address will be + used instead. + Likewise, if either of the Resent-Sender or Resent-From headers are set, then the + message will be encrypted to all of the addresses specified in the Resent headers + (Resent-Sender, Resent-From, Resent-To, Resent-Cc, and Resent-Bcc), + otherwise the message will be encrypted to all of the addresses specified in + the standard address headers (Sender, From, To, Cc, and Bcc). + + An asynchronous task context. + The cryptography context. + The digest algorithm. + The cancellation token. + + is null. + + + An unknown type of cryptography context was used. + + + The was out of range. + + + The has not been set. + -or- + No sender has been specified. + -or- + No recipients have been specified. + + + The is not supported. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for the signer or one or more of the recipients. + + + The private key could not be found for the sender. + + + The public key could not be found for one or more of the recipients. + + + + + Sign and encrypt the message to the sender and all of the recipients using + the specified cryptography context and the SHA-1 digest algorithm. + + + If either of the Resent-Sender or Resent-From headers are set, then the message + will be signed using the Resent-Sender (or first mailbox in the Resent-From) + address as the signer address, otherwise the Sender or From address will be + used instead. + Likewise, if either of the Resent-Sender or Resent-From headers are set, then the + message will be encrypted to all of the addresses specified in the Resent headers + (Resent-Sender, Resent-From, Resent-To, Resent-Cc, and Resent-Bcc), + otherwise the message will be encrypted to all of the addresses specified in + the standard address headers (Sender, From, To, Cc, and Bcc). + + The cryptography context. + The cancellation token. + + is null. + + + An unknown type of cryptography context was used. + + + The has not been set. + -or- + No sender has been specified. + -or- + No recipients have been specified. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for the signer or one or more of the recipients. + + + The private key could not be found for the sender. + + + The public key could not be found for one or more of the recipients. + + + + + Asynchronously sign and encrypt the message to the sender and all of the recipients using + the specified cryptography context and the SHA-1 digest algorithm. + + + If either of the Resent-Sender or Resent-From headers are set, then the message + will be signed using the Resent-Sender (or first mailbox in the Resent-From) + address as the signer address, otherwise the Sender or From address will be + used instead. + Likewise, if either of the Resent-Sender or Resent-From headers are set, then the + message will be encrypted to all of the addresses specified in the Resent headers + (Resent-Sender, Resent-From, Resent-To, Resent-Cc, and Resent-Bcc), + otherwise the message will be encrypted to all of the addresses specified in + the standard address headers (Sender, From, To, Cc, and Bcc). + + An asynchronous task context. + The cryptography context. + The cancellation token. + + is null. + + + An unknown type of cryptography context was used. + + + The has not been set. + -or- + No sender has been specified. + -or- + No recipients have been specified. + + + The operation was canceled via the cancellation token. + + + A certificate could not be found for the signer or one or more of the recipients. + + + The private key could not be found for the sender. + + + The public key could not be found for one or more of the recipients. + + + + + Releases the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + Releases all resources used by the object. + + Call when you are finished using the . The + method leaves the in an unusable state. After + calling , you must release all references to the so + the garbage collector can reclaim the memory that the was occupying. + + + + Load a from the specified stream. + + + Loads a from the given stream, using the + specified . + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + + The parsed message. + The parser options. + The stream. + true if the stream is persistent; otherwise false. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified stream. + + + Loads a from the given stream, using the + specified . + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + + The parsed message. + The parser options. + The stream. + true if the stream is persistent; otherwise false. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified stream. + + + Loads a from the given stream, using the + specified . + + The parsed message. + The parser options. + The stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified stream. + + + Loads a from the given stream, using the + specified . + + The parsed message. + The parser options. + The stream. + The cancellation token. + + is null. + -or- + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified stream. + + + Loads a from the given stream, using the + default . + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + + The parsed message. + The stream. + true if the stream is persistent; otherwise false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified stream. + + + Loads a from the given stream, using the + default . + If is true and is seekable, then + the will not copy the content of s into memory. Instead, + it will use a to reference a substream of . + This has the potential to not only save memory usage, but also improve + performance. + + The parsed message. + The stream. + true if the stream is persistent; otherwise false. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified stream. + + + Loads a from the given stream, using the + default . + + The parsed message. + The stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified stream. + + + Loads a from the given stream, using the + default . + + The parsed message. + The stream. + The cancellation token. + + is null. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified file. + + + Loads a from the file at the given path, using the + specified . + + The parsed message. + The parser options. + The name of the file to load. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified file. + + + Loads a from the file at the given path, using the + specified . + + The parsed message. + The parser options. + The name of the file to load. + The cancellation token. + + is null. + -or- + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Load a from the specified file. + + + Loads a from the file at the given path, using the + default . + + The parsed message. + The name of the file to load. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Asynchronously load a from the specified file. + + + Loads a from the file at the given path, using the + default . + + The parsed message. + The name of the file to load. + The cancellation token. + + is null. + + + is a zero-length string, contains only white space, or + contains one or more invalid characters. + + + is an invalid file path. + + + The specified file path could not be found. + + + The user does not have access to read the specified file. + + + The operation was canceled via the cancellation token. + + + There was an error parsing the entity. + + + An I/O error occurred. + + + + + Create a new from a . + + + Creates a new from a . + + The equivalent . + The message. + + is null. + + + + + Explicit cast to convert a to a + . + + + Allows creation of messages using Microsoft's System.Net.Mail APIs. + + The equivalent . + The message. + + + + Event args emitted by the when it begins parsing a . + + + Event args emitted by the when it begins parsing a . + + + + + Initialize a new instance of the class. + + + Creates a new . + + The message that was parsed. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The message that was parsed. + The parent message part. + + is null. + -or- + is null. + + + + + Get the message that was parsed. + + + Gets the message that was parsed. + + The message. + + + + Get the parent if this message is an attachment. + + + Gets the parent if this message is an attachment. + + The parent . + + + + Get or set the stream offset that marks the beginning of the message. + + + Gets or sets the stream offset that marks the beginning of the message. + + The stream offset. + + + + Get or set the line number of the beginning of the message. + + + Gets or sets the line number of the beginning of the message. + + The line number. + + + + Event args emitted by the when a is parsed. + + + Event args emitted by the when a is parsed. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The message that was parsed. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The message that was parsed. + The parent message part. + + is null. + -or- + is null. + + + + + Get or set the stream offset that marks the end of the message headers. + + + Gets or sets the stream offset that marks the end of the message headers. + + The stream offset. + + + + Get or set the stream offset that marks the end of the message. + + + Gets or sets the stream offset that marks the end of the message. + + The stream offset. + + + + A leaf-node MIME part that contains content such as the message body text or an attachment. + + + A leaf-node MIME part that contains content such as the message body text or an attachment. + + + + + + + + Initialize a new instance of the class + based on the . + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class + with the specified media type and subtype. + + + Creates a new with the specified media type and subtype. + + The media type. + The media subtype. + An array of initialization parameters: headers and part content. + + is null. + -or- + is null. + -or- + is null. + + + contains more than one or + . + -or- + contains one or more arguments of an unknown type. + + + + + Initialize a new instance of the class + with the specified media type and subtype. + + + Creates a new with the specified media type and subtype. + + The media type. + The media subtype. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class + with the specified content type. + + + Creates a new with the specified Content-Type value. + + The content type. + + is null. + + + + + Initialize a new instance of the class + with the specified content type. + + + Creates a new with the specified Content-Type value. + + The content type. + + is null. + + + could not be parsed. + + + + + Initialize a new instance of the class + with the default Content-Type of application/octet-stream. + + + Creates a new with a Content-Type of application/octet-stream. + + + + + Get or set the description of the content if available. + + + The Content-Description header can be used to set a description of the content. + + The description of the content. + + is negative. + + + The has been disposed. + + + + + Get or set the duration of the content if available. + + + The Content-Duration header specifies duration of timed media, + such as audio or video, in seconds. + + The duration of the content. + + is negative. + + + The has been disposed. + + + + + Get or set the md5sum of the content. + + + The Content-MD5 header specifies the base64-encoded MD5 checksum of the content + in its canonical format. + For more information, see rfc1864. + + The md5sum of the content. + + The has been disposed. + + + + + Get or set the content transfer encoding. + + + The Content-Transfer-Encoding header specifies an auxiliary encoding + that was applied to the content in order to allow it to pass through + mail transport mechanisms (such as SMTP) which may have limitations + in the byte ranges that it accepts. For example, many SMTP servers + do not accept data outside of the 7-bit ASCII range and so sending + binary attachments or even non-English text is not possible without + applying an encoding such as base64 or quoted-printable. + + The content transfer encoding. + + is not a valid content encoding. + + + The has been disposed. + + + + + Get or set the name of the file. + + + First checks for the "filename" parameter on the Content-Disposition header. If + that does not exist, then the "name" parameter on the Content-Type header is used. + When setting the filename, both the "filename" parameter on the Content-Disposition + header and the "name" parameter on the Content-Type header are set. + + + + + The name of the file. + + The has been disposed. + + + + + Get or set the MIME content. + + + Gets or sets the MIME content. + + + + + The MIME content. + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Calculate the most efficient content encoding given the specified constraint. + + + If no is set, will be returned. + + The most efficient content encoding. + The encoding constraint. + The cancellation token. + + is not a valid value. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Calculate the most efficient content encoding given the specified constraint. + + + If no is set, will be returned. + + The most efficient content encoding. + The encoding constraint. + The maximum allowable length for a line (not counting the CRLF). Must be between 72 and 998 (inclusive). + The cancellation token. + + is not between 72 and 998 (inclusive). + -or- + is not a valid value. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Compute the MD5 checksum of the content. + + + Computes the MD5 checksum of the MIME content in its canonical + format and then base64-encodes the result. + + The md5sum of the content. + + The has been disposed. + + + The is null. + + + + + Verify the Content-Md5 value against an independently computed md5sum. + + + Computes the MD5 checksum of the MIME content and compares it with the + value in the Content-MD5 header, returning true if and only if + the values match. + + true, if content MD5 checksum was verified, false otherwise. + + The has been disposed. + + + + + Prepare the MIME entity for transport using the specified encoding constraints. + + + Prepares the MIME entity for transport using the specified encoding constraints. + + The encoding constraint. + The maximum number of octets allowed per line (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + -or- + is not a valid value. + + + The has been disposed. + + + + + Write the to the specified output stream. + + + Writes the MIME part to the output stream. + + The formatting options. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Asynchronously writes the MIME part to the output stream. + + An awaitable task. + The formatting options. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Called when the headers change in some way. + + + Updates the , , + and properties if the corresponding headers have changed. + + The type of change. + The header being added, changed or removed. + + + + Releases the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + A mapping of file name extensions to the corresponding MIME-type. + + + A mapping of file name extensions to the corresponding MIME-type. + + + + + Get the MIME-type of a file. + + + Gets the MIME-type of a file based on the file extension. + + The MIME-type. + The file name. + + is null. + + + + + Get the standard file extension for a MIME-type. + + + Gets the standard file extension for a MIME-type. + + true if the extension is known for the specified MIME-type; otherwise, false. + The MIME-type. + The file name extension for the specified MIME-type. + + is null. + + + + + Register a MIME-type to file extension mapping. + + + Registers a MIME-type to file extension mapping. + If the mapping for the MIME-type and/or file extension already exists, + then it is overridden by the new mapping. + + The MIME-type to register. + The file extension to register. + + is null. + -or- + is null. + + + is empty. + -or- + is empty. + + + + + Represents a visitor for MIME trees. + + + This class is designed to be inherited to create more specialized classes whose + functionality requires traversing, examining or copying a MIME tree. + + + + + + + + Dispatches the entity to one of the more specialized visit methods in this class. + + + Dispatches the entity to one of the more specialized visit methods in this class. + + The MIME entity. + + + + Dispatches the message to one of the more specialized visit methods in this class. + + + Dispatches the message to one of the more specialized visit methods in this class. + + The MIME message. + + + + Visit the application/pgp-encrypted MIME entity. + + + Visits the application/pgp-encrypted MIME entity. + + + The application/pgp-encrypted MIME entity. + + + + Visit the application/pgp-signature MIME entity. + + + Visits the application/pgp-signature MIME entity. + + + The application/pgp-signature MIME entity. + + + + Visit the application/pkcs7-mime MIME entity. + + + Visits the application/pkcs7-mime MIME entity. + + The application/pkcs7-mime MIME entity. + + + + Visit the application/pkcs7-signature MIME entity. + + + Visits the application/pkcs7-signature MIME entity. + + + The application/pkcs7-signature MIME entity. + + + + Visit the message/disposition-notification MIME entity. + + + Visits the message/disposition-notification MIME entity. + + The message/disposition-notification MIME entity. + + + + Visit the message/delivery-status MIME entity. + + + Visits the message/delivery-status MIME entity. + + The message/delivery-status MIME entity. + + + + Visit the message/feedback-report MIME entity. + + + Visits the message/feedback-report MIME entity. + + The message/feedback-report MIME entity. + + + + Visit the message contained within a message/rfc822 or message/news MIME entity. + + + Visits the message contained within a message/rfc822 or message/news MIME entity. + + The message/rfc822 or message/news MIME entity. + + + + Visit the message/rfc822 or message/news MIME entity. + + + Visits the message/rfc822 or message/news MIME entity. + + + + + The message/rfc822 or message/news MIME entity. + + + + Visit the message/partial MIME entity. + + + Visits the message/partial MIME entity. + + The message/partial MIME entity. + + + + Visit the abstract MIME entity. + + + Visits the abstract MIME entity. + + The MIME entity. + + + + Visit the body of the message. + + + Visits the body of the message. + + The message. + + + + Visit the MIME message. + + + Visits the MIME message. + + The MIME message. + + + + Visit the abstract MIME part entity. + + + Visits the MIME part entity. + + + + + The MIME part entity. + + + + Visit the children of a . + + + Visits the children of a . + + Multipart. + + + + Visit the abstract multipart MIME entity. + + + Visits the abstract multipart MIME entity. + + The multipart MIME entity. + + + + Visit the multipart/alternative MIME entity. + + + Visits the multipart/alternative MIME entity. + + + + + The multipart/alternative MIME entity. + + + + Visit the multipart/encrypted MIME entity. + + + Visits the multipart/encrypted MIME entity. + + The multipart/encrypted MIME entity. + + + + Visit the multipart/related MIME entity. + + + Visits the multipart/related MIME entity. + + + + + The multipart/related MIME entity. + + + + Visit the multipart/report MIME entity. + + + Visits the multipart/report MIME entity. + + + + + The multipart/report MIME entity. + + + + Visit the multipart/signed MIME entity. + + + Visits the multipart/signed MIME entity. + + The multipart/signed MIME entity. + + + + Visit the text-based MIME part entity. + + + Visits the text-based MIME part entity. + + + + + The text-based MIME part entity. + + + + Visit the text/rfc822-headers MIME entity. + + + Visits the text/rfc822-headers MIME entity. + + + + + The text/rfc822-headers MIME entity. + + + + Visit the Microsoft TNEF MIME part entity. + + + Visits the Microsoft TNEF MIME part entity. + + + + + The Microsoft TNEF MIME part entity. + + + + A multipart MIME entity which may contain a collection of MIME entities. + + + All multipart MIME entities will have a Content-Type with a media type of "multipart". + The most common multipart MIME entity used in email is the "multipart/mixed" entity. + Four (4) initial subtypes were defined in the original MIME specifications: mixed, alternative, + digest, and parallel. + The "multipart/mixed" type is a sort of general-purpose container. When used in email, the + first entity is typically the "body" of the message while additional entities are most often + file attachments. + Speaking of message "bodies", the "multipart/alternative" type is used to offer a list of + alternative formats for the main body of the message (usually they will be "text/plain" and + "text/html"). These alternatives are in order of increasing faithfulness to the original document + (in other words, the last entity will be in a format that, when rendered, will most closely match + what the sending client's WYSISYG editor produced). + The "multipart/digest" type will typically contain a digest of MIME messages and is most + commonly used by mailing-list software. + The "multipart/parallel" type contains entities that are all meant to be shown (or heard) + in parallel. + Another commonly used type is the "multipart/related" type which contains, as one might expect, + inter-related MIME parts which typically reference each other via URIs based on the Content-Id and/or + Content-Location headers. + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new with the specified subtype. + + The multipart media sub-type. + An array of initialization parameters: headers and MIME entities. + + is null. + -or- + is null. + + + contains one or more arguments of an unknown type. + + + + + Initialize a new instance of the class. + + + Creates a new with the specified subtype. + + The multipart media sub-type. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new with a ContentType of multipart/mixed. + + + + + Get or set the boundary. + + + Gets or sets the boundary parameter on the Content-Type header. + + The boundary. + + is null. + + + + + Get or set the preamble. + + + A multipart preamble appears before the first child entity of the + multipart and is typically used only in the top-level multipart + of the message to specify that the message is in MIME format and + therefore requires a MIME compliant email application to render + it correctly. + + The preamble. + + The has been disposed. + + + + + Get or set the epilogue. + + + A multipart epiloque is the text that appears after the closing boundary + of the multipart and is typically either empty or a single new line + character sequence. + + The epilogue. + + The has been disposed. + + + + + Get or set whether the end boundary should be written. + + + Gets or sets whether the end boundary should be written. + + true if the end boundary should be written; otherwise, false. + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Get the preferred message body if it exists. + + + Gets the preferred message body if it exists. + + The preferred text format. + The MIME part containing the message body in the preferred text format. + true if the body part is found; otherwise, false. + + The has been disposed. + + + + + Prepare the MIME entity for transport using the specified encoding constraints. + + + Prepares the MIME entity for transport using the specified encoding constraints. + + The encoding constraint. + The maximum number of octets allowed per line (not counting the CRLF). Must be between 60 and 998 (inclusive). + + is not between 60 and 998 (inclusive). + -or- + is not a valid value. + + + The has been disposed. + + + + + Write the to the specified output stream. + + + Writes the multipart MIME entity and its subparts to the output stream. + + The formatting options. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Asynchronously write the to the specified output stream. + + + Asynchronously writes the multipart MIME entity and its subparts to the output stream. + + An awaitable task. + The formatting options. + The output stream. + true if only the content should be written; otherwise, false. + The cancellation token. + + is null. + -or- + is null. + + + The has been disposed. + + + The operation was canceled via the cancellation token. + + + An I/O error occurred. + + + + + Get the number of parts in the multipart. + + + Indicates the number of parts in the multipart. + + The number of parts in the multipart. + + + + Get a value indicating whether this instance is read only. + + + A is never read-only. + + true if this instance is read only; otherwise, false. + + + + Add an entity to the multipart. + + + Adds an entity to the multipart without changing the WriteEndBoundary state. + + The MIME entity to add. + + + + Add an entity to the multipart. + + + Adds the specified part to the multipart. + + The MIME entity to add. + + is null. + + + The has been disposed. + + + + + Clear a multipart. + + + Removes all of the entities within the multipart. + + + The has been disposed. + + + + + Clear a multipart. + + + Removes all of the entities within the multipart, optionally disposing them in the process. + + true if all of the child entities of the multipart should be disposed; otherwise, false. + + The has been disposed. + + + + + Check if the contains the specified entity. + + + Determines whether or not the multipart contains the specified entity. + + true if the specified entity exists; + otherwise false. + The entity to check for. + + is null. + + + The has been disposed. + + + + + Copy all of the entities in the to the specified array. + + + Copies all of the entities within the into the array, + starting at the specified array index. + + The array to copy the child entities to. + The index into the array. + + is null. + + + is out of range. + + + The has been disposed. + + + + + Remove an entity from the multipart. + + + Removes the specified entity if it exists within the multipart. + + true if the part was removed; otherwise false. + The MIME entity to remove. + + is null. + + + The has been disposed. + + + + + Get the index of an entity. + + + Finds the index of the specified entity, if it exists. + + The index of the specified entity if found; otherwise -1. + The MIME entity. + + is null. + + + The has been disposed. + + + + + Insert an entity into the at the specified index. + + + Inserts the part into the multipart at the specified index. + + The index. + The MIME entity. + + is null. + + + is out of range. + + + The has been disposed. + + + + + Remove an entity from the at the specified index. + + + Removes the entity at the specified index. + It is the responsibility of the caller to dispose the entity at the specified . + + The index. + + is out of range. + + + The has been disposed. + + + + + Get or set the at the specified index. + + + Gets or sets the at the specified index. + It is the responsibility of the caller to dispose the original entity at the specified . + + The entity at the specified index. + The index. + + is null. + + + is out of range. + + + The has been disposed. + + + + + Get the enumerator for the children of the . + + + Gets the enumerator for the children of the . + + The enumerator. + + The has been disposed. + + + + + Get the enumerator for the children of the . + + + Gets the enumerator for the children of the . + + The enumerator. + + The has been disposed. + + + + + Release the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + A multipart/alternative MIME entity. + + + A multipart/alternative MIME entity contains, as one might expect, is used to offer a list of + alternative formats for the main body of the message (usually they will be "text/plain" and + "text/html"). These alternatives are in order of increasing faithfulness to the original document + (in other words, the last entity will be in a format that, when rendered, will most closely match + what the sending client's WYSISYG editor produced). + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new part. + + An array of initialization parameters: headers and MIME entities. + + is null. + + + contains one or more arguments of an unknown type. + + + + + Initialize a new instance of the class. + + + Creates a new part. + + + + + Get the text of the text/plain alternative. + + + Gets the text of the text/plain alternative, if it exists. + + The text if a text/plain alternative exists; otherwise, null. + + The has been disposed. + + + + + Get the HTML-formatted text of the text/html alternative. + + + Gets the HTML-formatted text of the text/html alternative, if it exists. + + The HTML if a text/html alternative exists; otherwise, null. + + The has been disposed. + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Get the text body in the specified format. + + + Gets the text body in the specified format, if it exists. + + The text body in the desired format if it exists; otherwise, null. + The desired text format. + + The has been disposed. + + + + + Get the preferred message body if it exists. + + + Gets the preferred message body if it exists. + + The preferred text format. + The MIME part containing the message body in the preferred text format. + true if the body part is found; otherwise, false. + + The has been disposed. + + + + + A multipart/related MIME entity. + + + A multipart/related MIME entity contains, as one might expect, inter-related MIME parts which + typically reference each other via URIs based on the Content-Id and/or Content-Location headers. + + + + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new part. + + An array of initialization parameters: headers and MIME entities. + + is null. + + + contains one or more arguments of an unknown type. + + + + + Initialize a new instance of the class. + + + Creates a new part. + + + + + Get or set the root document of the multipart/related part and the appropriate Content-Type parameters. + + + Gets or sets the root document that references the other MIME parts within the multipart/related. + When getting the root document, the "start" parameter of the Content-Type header is used to + determine which of the parts is the root. If the "start" parameter does not exist or does not reference + any of the child parts, then the first child is assumed to be the root. + When setting the root document MIME part, the Content-Type header of the multipart/related part is also + updated with a appropriate "start" and "type" parameters. + + + + + The root MIME part. + + is null. + + + The has been disposed. + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Get the preferred message body if it exists. + + + Gets the preferred message body if it exists. + + The preferred text format. + The MIME part containing the message body in the preferred text format. + true if the body part is found; otherwise, false. + + The has been disposed. + + + + + Check if the contains a part matching the specified URI. + + + Determines whether or not the multipart/related entity contains a part matching the specified URI. + + true if the specified part exists; otherwise false. + The URI of the MIME part. + + is null. + + + The has been disposed. + + + + + Get the index of the part matching the specified URI. + + + Finds the index of the part matching the specified URI, if it exists. + If the URI scheme is "cid", then matching is performed based on the Content-Id header + values, otherwise the Content-Location headers are used. If the provided URI is absolute and a child + part's Content-Location is relative, then then the child part's Content-Location URI will be combined + with the value of its Content-Base header, if available, otherwise it will be combined with the + multipart/related part's Content-Base header in order to produce an absolute URI that can be + compared with the provided absolute URI. + + + + + The index of the part matching the specified URI if found; otherwise -1. + The URI of the MIME part. + + is null. + + + The has been disposed. + + + + + Open a stream for reading the decoded content of the MIME part specified by the provided URI. + + + Opens a stream for reading the decoded content of the MIME part specified by the provided URI. + + A stream for reading the decoded content of the MIME part specified by the provided URI. + The URI. + The mime-type of the content. + The charset of the content (if the content is text-based) + + is null. + + + The MIME part for the specified URI could not be found. + + + The has been disposed. + + + + + Open a stream for reading the decoded content of the MIME part specified by the provided URI. + + + Opens a stream for reading the decoded content of the MIME part specified by the provided URI. + + A stream for reading the decoded content of the MIME part specified by the provided URI. + The URI. + + is null. + + + The MIME part for the specified URI could not be found. + + + The has been disposed. + + + + + A multipart/report MIME entity. + + + A multipart/related MIME entity is a general container part for electronic mail + reports of any kind. + + + + + + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new part. + + The type of the report. + An array of initialization parameters: headers and MIME entities. + + is null. + -or- + is null. + + + contains one or more arguments of an unknown type. + + + + + Initialize a new instance of the class. + + + Creates a new part. + + The type of the report. + + is null. + + + + + Get or set the type of the report. + + + Gets or sets the type of the report. + The report type should be the subtype of the second + of the multipart/report. + + + + + The type of the report. + + is null. + + + The has been disposed. + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + A header parameter as found in the Content-Type and Content-Disposition headers. + + + Content-Type and Content-Disposition headers often have parameters that specify + further information about how to interpret the content. + + + + + Initialize a new instance of the class. + + + Creates a new parameter with the specified name and value. + + The parameter name. + The parameter value. + + is null. + -or- + is null. + + + contains illegal characters. + + + + + Initialize a new instance of the class. + + + Creates a new parameter with the specified name and value. + + The character encoding. + The parameter name. + The parameter value. + + is null. + -or- + is null. + -or- + is null. + + + contains illegal characters. + + + + + Initialize a new instance of the class. + + + Creates a new parameter with the specified name and value. + + The character encoding. + The parameter name. + The parameter value. + + is null. + -or- + is null. + -or- + is null. + + + contains illegal characters. + + + is not supported. + + + + + Get the parameter name. + + + Gets the parameter name. + + The parameter name. + + + + Get or set the parameter value character encoding. + + + Gets or sets the parameter value character encoding. + + The character encoding. + + + + Get or set the parameter encoding method to use. + + + Gets or sets the parameter encoding method to use. + The MIME specifications specify that the proper method for encoding Content-Type + and Content-Disposition parameter values is the method described in + rfc2231. However, it is common for + some older email clients to improperly encode using the method described in + rfc2047 instead. + If set to , the encoding + method used will default to the value set on the . + + + + + The encoding method. + + is not a valid value. + + + + + Get or set whether the parameter value should always be quoted even if it normally wouldn't need to be. + + + Gets or sets whether the parameter value should always be quoted even if it normally wouldn't need to be. + Technically, Content-Type and Content-Disposition parameter values only require quoting when they contain characters + that have special meaning to a MIME parser. However, for compatibility with email processing solutions that do not properly + adhere to the MIME specifications, this property can be used to force MimeKit to quote parameter values that would normally + not require quoting. + + true if the parameter value should always be quoted; otherwise, false. + + + + Get or set the parameter value. + + + Gets or sets the parameter value. + + The parameter value. + + is null. + + + + + Clone the parameter. + + + Clones the parameter. + + The cloned parameter. + + + + Return a string representation of the . + + + Formats the parameter name and value in the form name="value". + + A string representation of the . + + + + The method to use for encoding Content-Type and Content-Disposition parameter values. + + + The MIME specifications specify that the proper method for encoding Content-Type and + Content-Disposition parameter values is the method described in + rfc2231. However, it is common for + some older email clients to improperly encode using the method described in + rfc2047 instead. + + + + + + + + Use the default encoding method set on the . + + + + + Use the encoding method described in rfc2231. + + + + + Use the encoding method described in rfc2047 (for compatibility with older, + non-rfc-compliant email clients). + + + + + A list of parameters, as found in the Content-Type and Content-Disposition headers. + + + Parameters are used by both and . + + + + + Initialize a new instance of the class. + + + Creates a new parameter list. + + + + + Add a parameter with the specified name and value. + + + Adds a new parameter to the list with the specified name and value. + + The parameter name. + The parameter value. + + is null. + -or- + is null. + + + The contains illegal characters. + + + + + Add a parameter with the specified name and value. + + + Adds a new parameter to the list with the specified name and value. + + The character encoding. + The parameter name. + The parameter value. + + is null. + -or- + is null. + -or- + is null. + + + contains illegal characters. + + + + + Add a parameter with the specified name and value. + + + Adds a new parameter to the list with the specified name and value. + + The character encoding. + The parameter name. + The parameter value. + + is null. + -or- + is null. + -or- + is null. + + + cannot be empty. + -or- + contains illegal characters. + + + is not supported. + + + + + Check if the contains a parameter with the specified name. + + + Determines whether or not the parameter list contains a parameter with the specified name. + + true if the requested parameter exists; + otherwise false. + The parameter name. + + is null. + + + + + Get the index of the requested parameter, if it exists. + + + Finds the index of the parameter with the specified name, if it exists. + + The index of the requested parameter; otherwise -1. + The parameter name. + + is null. + + + + + Insert a parameter with the specified name and value at the given index. + + + Inserts a new parameter with the given name and value at the specified index. + + The index to insert the parameter. + The parameter name. + The parameter value. + + is null. + -or- + is null. + + + The contains illegal characters. + + + is out of range. + + + + + Remove the specified parameter. + + + Removes the parameter with the specified name from the list, if it exists. + + true if the specified parameter was removed; + otherwise false. + The parameter name. + + is null. + + + + + Get or set the value of a parameter with the specified name. + + + Gets or sets the value of a parameter with the specified name. + + The value of the specified parameter if it exists; otherwise null. + The parameter name. + + is null. + -or- + is null. + + + The contains illegal characters. + + + + + Get the parameter with the specified name. + + + Gets the parameter with the specified name. + + + + + true if the parameter exists; otherwise, false. + The parameter name. + The parameter. + + is null. + + + + + Get the value of the parameter with the specified name. + + + Gets the value of the parameter with the specified name. + + true if the parameter exists; otherwise, false. + The parameter name. + The parameter value. + + is null. + + + + + Get the number of parameters in the . + + + Indicates the number of parameters in the list. + + The number of parameters. + + + + Get a value indicating whether this instance is read only. + + + A is never read-only. + + true if this instance is read only; otherwise, false. + + + + Add a to a . + + + Adds the specified parameter to the end of the list. + + The parameter to add. + + The is null. + + + A parameter with the same name as + already exists. + + + + + Clear the parameter list. + + + Removes all of the parameters from the list. + + + + + Check if the contains the specified parameter. + + + Determines whether or not the parameter list contains the specified parameter. + + true if the specified parameter is contained; + otherwise false. + The parameter. + + The is null. + + + + + Copy all of the parameters in the list to an array. + + + Copies all of the parameters within the into the array, + starting at the specified array index. + + The array to copy the parameters to. + The index into the array. + + + + Remove a from a . + + + Removes the specified parameter from the list. + + true if the specified parameter was removed; + otherwise false. + The parameter. + + The is null. + + + + + Get the index of the requested parameter, if it exists. + + + Finds the index of the specified parameter, if it exists. + + The index of the requested parameter; otherwise -1. + The parameter. + + The is null. + + + + + Insert a at the specified index. + + + Inserts the parameter at the specified index in the list. + + The index to insert the parameter. + The parameter. + + The is null. + + + The is out of range. + + + A parameter with the same name as + already exists. + + + + + Remove the parameter at the specified index. + + + Removes the parameter at the specified index. + + The index. + + The is out of range. + + + + + Get or set the at the specified index. + + + Gets or sets the at the specified index. + + The parameter at the specified index. + The index. + + The is null. + + + The is out of range. + + + A parameter with the same name as + already exists. + + + + + Get an enumerator for the list of parameters. + + + Gets an enumerator for the list of parameters. + + The enumerator. + + + + Get an enumerator for the list of parameters. + + + Gets an enumerator for the list of parameters. + + The enumerator. + + + + Serialize a to a string. + + + If there are multiple parameters in the list, they will be separated by a semicolon. + + A string representing the . + + + + A Parse exception as thrown by the various Parse methods in MimeKit. + + + A can be thrown by any of the Parse() methods + in MimeKit. Each exception instance will have a + which marks the byte offset of the token that failed to parse as well + as a which marks the byte offset where the error + occurred. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The serialization info. + The stream context. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The error message. + The byte offset of the token. + The byte offset of the error. + The inner exception. + + + + Initialize a new instance of the class. + + + Creates a new . + + The error message. + The byte offset of the token. + The byte offset of the error. + + + + When overridden in a derived class, sets the + with information about the exception. + + + Sets the + with information about the exception. + + The serialization info. + The streaming context. + + is null. + + + + + Get the byte index of the token that was malformed. + + + The token index is the byte offset at which the token started. + + The byte index of the token. + + + + Get the index of the byte that caused the error. + + + The error index is the byte offset at which the parser encountered an error. + + The index of the byte that caused error. + + + + Parser options as used by as well as various Parse and TryParse methods in MimeKit. + + + allows you to change and/or override default parsing options used by methods such + as and others. + + + + + The default parser options. + + + If a is not supplied to or other Parse and TryParse + methods throughout MimeKit, will be used. + + + + + Get or set the compliance mode that should be used when parsing rfc822 addresses. + + + In general, you'll probably want this value to be + (the default) as it allows maximum interoperability with existing (broken) mail clients + and other mail software such as sloppily written perl scripts (aka spambots). + Even in mode, the address parser + is fairly liberal in what it accepts. Setting it to + just makes it try harder to deal with garbage input. + + The RFC compliance mode. + + + + Get or set whether the rfc822 address parser should ignore unquoted commas in address names. + + + In general, you'll probably want this value to be true (the default) as it allows + maximum interoperability with existing (broken) mail clients and other mail software such as + sloppily written perl scripts (aka spambots) that do not properly quote the name when it + contains a comma. + + true if the address parser should ignore unquoted commas in address names; otherwise, false. + + + + Get or set whether the rfc822 address parser should allow addresses without a domain. + + + In general, you'll probably want this value to be true (the default) as it allows + maximum interoperability with older email messages that may contain local UNIX addresses. + This option exists in order to allow parsing of mailbox addresses that do not have an + @domain component. These types of addresses are rare and were typically only used when sending + mail to other users on the same UNIX system. + + true if the address parser should allow mailbox addresses without a domain; otherwise, false. + + + + Get or set the maximum address group depth the parser should accept. + + + This option exists in order to define the maximum recursive depth of an rfc822 group address + that the parser should accept before bailing out with the assumption that the address is maliciously + formed. If the value is set too large, then it is possible that a maliciously formed set of + recursive group addresses could cause a stack overflow. + + The maximum address group depth. + + + + Get or set the maximum MIME nesting depth the parser should accept. + + + This option exists in order to define the maximum recursive depth of MIME parts that the parser + should accept before treating further nesting as a leaf-node MIME part and not recursing any further. + If the value is set too large, then it is possible that a maliciously formed set of deeply nested + multipart MIME parts could cause a stack overflow. + + The maximum MIME nesting depth. + + + + Get or set the compliance mode that should be used when parsing Content-Type and Content-Disposition parameters. + + + In general, you'll probably want this value to be + (the default) as it allows maximum interoperability with existing (broken) mail clients + and other mail software such as sloppily written perl scripts (aka spambots). + Even in mode, the parameter parser + is fairly liberal in what it accepts. Setting it to + just makes it try harder to deal with garbage input. + + The RFC compliance mode. + + + + Get or set the compliance mode that should be used when decoding rfc2047 encoded words. + + + In general, you'll probably want this value to be + (the default) as it allows maximum interoperability with existing (broken) mail clients + and other mail software such as sloppily written perl scripts (aka spambots). + + The RFC compliance mode. + + + + Get or set a value indicating whether the Content-Length value should be + respected when parsing mbox streams. + + + For more details about why this may be useful, you can find more information + at + http://www.jwz.org/doc/content-length.html. + + true if the Content-Length value should be respected; + otherwise, false. + + + + Get or set the charset encoding to use as a fallback for 8bit headers. + + + and + + use this charset encoding as a fallback when decoding 8bit text into unicode. The first + charset encoding attempted is UTF-8, followed by this charset encoding, before finally + falling back to iso-8859-1. + + The charset encoding. + + + + Initialize a new instance of the class. + + + By default, new instances of enable rfc2047 work-arounds + (which are needed for maximum interoperability with mail software used in the wild) + and do not respect the Content-Length header value. + + + + + Clone an instance of . + + + Clones a set of options, allowing you to change a specific option + without requiring you to change the original. + + An identical copy of the current instance. + + + + Register a subclass for the specified mime-type. + + The MIME type. + A custom subclass of . + + Your custom class should not subclass + directly, but rather it should subclass + , , + , or one of their derivatives. + + + is null. + -or- + is null. + + + is not a subclass of , + , or . + -or- + does not have a constructor that takes + only a argument. + + + + + An RFC compliance mode. + + + An RFC compliance mode. + + + + + Attempt to be even more liberal in accepting broken and/or invalid formatting. + + + + + Attempt to be more liberal accepting broken and/or invalid formatting. + + + + + Do not attempt to be overly liberal in accepting broken and/or invalid formatting. + + + + + A textual MIME part. + + + Unless overridden, all textual parts parsed by the , + such as text/plain or text/html, will be represented by a . + For more information about text media types, see section 4.1 of + rfc2046. + + + + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the + class with the specified text subtype. + + + Creates a new with the specified subtype. + Typically the should either be + "plain" for plain text content or "html" for HTML content. + For more options, check the MIME-type registry at + + http://www.iana.org/assignments/media-types/media-types.xhtml#text + + + The media subtype. + An array of initialization parameters: headers, charset encoding and text. + + is null. + -or- + is null. + + + contains more than one . + -or- + contains more than one . + -or- + contains one or more arguments of an unknown type. + + + + + Initialize a new instance of the + class with the specified text subtype. + + + Creates a new with the specified subtype. + Typically the should either be + "plain" for plain text content or "html" for HTML content. + For more options, check the MIME-type registry at + + http://www.iana.org/assignments/media-types/media-types.xhtml#text + + + The media subtype. + + is null. + + + + + Initialize a new instance of the + class with the specified text format. + + + Creates a new with the specified text format. + + The text format. + + is out of range. + + + + + Initialize a new instance of the + class with a Content-Type of text/plain. + + + Creates a default with a mime-type of text/plain. + + + + + Get the text format of the content. + + + Gets the text format of the content. + + The text format of the content. + + The has been disposed. + + + + + Get whether or not this text part contains enriched text. + + + Checks whether or not the text part's Content-Type is text/enriched or its + predecessor, text/richtext (not to be confused with text/rtf). + + true if the text is enriched; otherwise, false. + + The has been disposed. + + + + + Get whether or not this text part contains flowed text. + + + Checks whether or not the text part's Content-Type is text/plain and + has a format parameter with a value of flowed. + + + + + true if the text is flowed; otherwise, false. + + The has been disposed. + + + + + Get whether or not this text part contains HTML. + + + Checks whether or not the text part's Content-Type is text/html. + + + + + true if the text is html; otherwise, false. + + The has been disposed. + + + + + Get whether or not this text part contains plain text. + + + Checks whether or not the text part's Content-Type is text/plain. + + true if the text is html; otherwise, false. + + The has been disposed. + + + + + Get whether or not this text part contains RTF. + + + Checks whether or not the text part's Content-Type is text/rtf. + + true if the text is RTF; otherwise, false. + + The has been disposed. + + + + + Get the decoded text content. + + + If the charset parameter on the + is set, it will be used in order to convert the raw content into unicode. + If that fails or if the charset parameter is not set, the first 2 bytes of + the content will be checked for a unicode BOM. If a BOM exists, then that + will be used for conversion. If no BOM is found, then UTF-8 is attempted. + If conversion fails, then iso-8859-1 will be used as the final fallback. + For more control, use + or . + + The decocded text. + + The has been disposed. + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Determine whether or not the text is in the specified format. + + + Determines whether or not the text is in the specified format. + + true if the text is in the specified format; otherwise, false. + The text format. + + The has been disposed. + + + + + Try to detect the encoding of the text content. + + + Attempts to detect the encoding of the text content. + If no content is defined, then is set to ASCII and + is set to . + If a charset is specified on the Content-Type header and it is a supported encoding, then + is set to the encoding for the specified charset and + is set to . + If a Byte-Order-Mark (BOM) is found, then is set to the corresponding unicode + encoding and is set to . + If the content is in HTML format, then the first 1024 bytes are processed for <meta> tags + containing charset information. If charset information is found and the charset is a supported encoding, then + is set to the encoding for the specified charset and is + set to . + + true if an encoding was detected; otherwise, false. + The detected encoding; otherwise, null. + The confidence in the detected encoding being correct. + + The has been disposed. + + + + + Get the decoded text and the encoding used to convert it into unicode. + + + If the charset parameter on the + is set, it will be used in order to convert the raw content into unicode. + If that fails or if the charset parameter is not set, the first 3 bytes of + the content will be checked for a unicode BOM. If a BOM exists, then that + will be used for conversion. If no BOM is found, then UTF-8 is attempted. + If conversion fails, then iso-8859-1 will be used as the final fallback. + For more control, use + or . + + The encoding used to convert the text into unicode. + The decoded text. + + The has been disposed. + + + + + Get the decoded text content using the provided charset encoding to + override the charset specified in the Content-Type parameters. + + + Uses the provided charset encoding to convert the raw text content + into a unicode string, overriding any charset specified in the + Content-Type header. + + The decoded text. + The charset encoding to use. + + is null. + + + The has been disposed. + + + + + Get the decoded text content using the provided charset to override + the charset specified in the Content-Type parameters. + + + Uses the provided charset encoding to convert the raw text content + into a unicode string, overriding any charset specified in the + Content-Type header. + + The decoded text. + The charset encoding to use. + + is null. + + + The is not supported. + + + The has been disposed. + + + + + Set the text content and the charset parameter in the Content-Type header. + + + This method is similar to setting the property, + but allows specifying a charset encoding to use. Also updates the + property. + + The charset encoding. + The text content. + + is null. + -or- + is null. + + + The has been disposed. + + + + + Set the text content and the charset parameter in the Content-Type header. + + + This method is similar to setting the property, + but allows specifying a charset encoding to use. Also updates the + property. + + The charset encoding. + The text content. + + is null. + -or- + is null. + + + The is not supported. + + + The has been disposed. + + + + + A MIME part containing message headers as its content. + + + Represents MIME entities with a Content-Type of text/rfc822-headers. + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + An array of initialization parameters: headers and message parts. + + is null. + + + contains more than one . + -or- + contains one or more arguments of an unknown type. + + + + + Initialize a new instance of the class. + + + Creates a new text/rfc822-headers MIME entity. + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + + + A flowed text to HTML converter. + + + Used to convert flowed text (as described in rfc3676) into HTML. + + + + + + + + Initialize a new instance of the class. + + + Creates a new flowed text to HTML converter. + + + + + Get the input format. + + + Gets the input format. + + The input format. + + + + Get the output format. + + + Gets the output format. + + The output format. + + + + Get or set whether the trailing space on a wrapped line should be deleted. + + + Gets or sets whether the trailing space on a wrapped line should be deleted. + The flowed text format defines a Content-Type parameter called "delsp" which can + have a value of "yes" or "no". If the parameter exists and the value is "yes", then + should be set to true, otherwise + should be set to false. + + + + + true if the trailing space on a wrapped line should be deleted; otherwise, false. + + + + Get or set the footer format. + + + Gets or sets the footer format. + + The footer format. + + + + Get or set the header format. + + + Gets or sets the header format. + + The header format. + + + + Get or set the method to use for custom + filtering of HTML tags and content. + + + Get or set the method to use for custom + filtering of HTML tags and content. + + The html tag callback. + + + + Get or set whether or not the converter should only output an HTML fragment. + + + Gets or sets whether or not the converter should only output an entire + HTML document or just a fragment of the HTML body content. + + true if the converter should only output an HTML fragment; otherwise, false. + + + + Convert the contents of from the to the + and uses the to write the resulting text. + + + Converts the contents of from the to the + and uses the to write the resulting text. + + The text reader. + The text writer. + + is null. + -or- + is null. + + + + + A flowed text to text converter. + + + Unwraps the flowed text format described in rfc3676. + + + + + Initialize a new instance of the class. + + + Creates a new flowed text to text converter. + + + + + Get the input format. + + + Gets the input format. + + The input format. + + + + Get the output format. + + + Gets the output format. + + The output format. + + + + Get or set whether the trailing space on a wrapped line should be deleted. + + + Gets or sets whether the trailing space on a wrapped line should be deleted. + The flowed text format defines a Content-Type parameter called "delsp" which can + have a value of "yes" or "no". If the parameter exists and the value is "yes", then + should be set to true, otherwise + should be set to false. + + true if the trailing space on a wrapped line should be deleted; otherwise, false. + + + + Convert the contents of from the to the + and uses the to write the resulting text. + + + Converts the contents of from the to the + and uses the to write the resulting text. + + The text reader. + The text writer. + + is null. + -or- + is null. + + + + + An enumeration of possible header and footer formats. + + + An enumeration of possible header and footer formats. + + + + + The header or footer contains plain text. + + + + + The header or footer contains properly formatted HTML. + + + + + An HTML attribute. + + + An HTML attribute. + + + + + + + + Initialize a new instance of the class. + + + Creates a new HTML attribute with the given id and value. + + The attribute identifier. + The attribute value. + + is not a valid value. + + + + + Initialize a new instance of the class. + + + Creates a new HTML attribute with the given name and value. + + The attribute name. + The attribute value. + + is null. + + + + + Get the HTML attribute identifier. + + + Gets the HTML attribute identifier. + + + + + The attribute identifier. + + + + Get the name of the attribute. + + + Gets the name of the attribute. + + + + + The name of the attribute. + + + + Get the value of the attribute. + + + Gets the value of the attribute. + + + + + The value of the attribute. + + + + A readonly collection of HTML attributes. + + + A readonly collection of HTML attributes. + + + + + An empty attribute collection. + + + An empty attribute collection. + + + + + Initialize a new instance of the class. + + + Creates a new . + + A collection of attributes. + + + + Get the number of attributes in the collection. + + + Gets the number of attributes in the collection. + + The number of attributes in the collection. + + + + Check if an attribute exists. + + + Checks if an attribute exists. + + The attribute. + true if the attribute exists within the collection; otherwise, false. + + + + Check if an attribute exists. + + + Checks if an attribute exists. + + The name of the attribute. + true if the attribute exists within the collection; otherwise, false. + + is null. + + + + + Get the index of a desired attribute. + + + Gets the index of a desired attribute. + + The attribute. + true if the attribute exists within the collection; otherwise, false. + + + + Get the index of a desired attribute. + + + Gets the index of a desired attribute. + + The name of the attribute. + true if the attribute exists within the collection; otherwise, false. + + is null. + + + + + Get the at the specified index. + + + Gets the at the specified index. + + The HTML attribute at the specified index. + The index. + + is out of range. + + + + + Get an attribute from the collection if it exists. + + + Gets an attribute from the collection if it exists. + + The id of the attribute. + The attribute if found; otherwise, null. + true if the desired attribute is found; otherwise, false. + + + + Get an attribute from the collection if it exists. + + + Gets an attribute from the collection if it exists. + + The name of the attribute. + The attribute if found; otherwise, null. + true if the desired attribute is found; otherwise, false. + + is null. + + + + + Get an enumerator for the attribute collection. + + + Gets an enumerator for the attribute collection. + + The enumerator. + + + + Get an enumerator for the attribute collection. + + + Gets an enumerator for the attribute collection. + + The enumerator. + + + + HTML attribute identifiers. + + + HTML attribute identifiers. + + + + + An unknown HTML attribute identifier. + + + + + The "abbr" attribute. + + + + + The "accept" attribute. + + + + + The "accept-charset" attribute. + + + + + The "accesskey" attribute. + + + + + The "action" attribute. + + + + + The "align" attribute. + + + + + The "alink" attribute. + + + + + The "alt" attribute. + + + + + The "archive" attribute. + + + + + The "axis" attribute. + + + + + The "background" attribute. + + + + + The "bgcolor" attribute. + + + + + The "border" attribute. + + + + + The "cellpadding" attribute. + + + + + The "cellspacing" attribute. + + + + + The "char" attribute. + + + + + The "charoff" attribute. + + + + + The "charset" attribute. + + + + + The "checked" attribute. + + + + + The "cite" attribute. + + + + + The "class" attribute. + + + + + The "classid" attribute. + + + + + The "clear" attribute. + + + + + The "code" attribute. + + + + + The "codebase" attribute. + + + + + The "codetype" attribute. + + + + + The "color" attribute. + + + + + The "cols" attribute. + + + + + The "colspan" attribute. + + + + + The "compact" attribute. + + + + + The "content" attribute. + + + + + The "coords" attribute. + + + + + The "data" attribute. + + + + + The "datetime" attribute. + + + + + The "declare" attribute. + + + + + The "defer" attribute. + + + + + The "dir" attribute. + + + + + The "disabled" attribute. + + + + + The "dynsrc" attribute. + + + + + The "enctype" attribute. + + + + + The "face" attribute. + + + + + The "for" attribute. + + + + + The "frame" attribute. + + + + + The "frameborder" attribute. + + + + + The "headers" attribute. + + + + + The "height" attribute. + + + + + The "href" attribute. + + + + + The "hreflang" attribute. + + + + + The "hspace" attribute. + + + + + The "http-equiv" attribute. + + + + + The "id" attribute. + + + + + The "ismap" attribute. + + + + + The "label" attribute. + + + + + The "lang" attribute. + + + + + The "language" attribute. + + + + + The "leftmargin" attribute. + + + + + The "link" attribute. + + + + + The "longdesc" attribute. + + + + + The "lowsrc" attribute. + + + + + The "marginheight" attribute. + + + + + The "marginwidth" attribute. + + + + + The "maxlength" attribute. + + + + + The "media" attribute. + + + + + The "method" attribute. + + + + + The "multiple" attribute. + + + + + The "name" attribute. + + + + + The "nohref" attribute. + + + + + The "noresize" attribute. + + + + + The "noshade" attribute. + + + + + The "nowrap" attribute. + + + + + The "object" attribute. + + + + + The "profile" attribute. + + + + + The "prompt" attribute. + + + + + The "readonly" attribute. + + + + + The "rel" attribute. + + + + + The "rev" attribute. + + + + + The "rows" attribute. + + + + + The "rowspan" attribute. + + + + + The "rules" attribute. + + + + + The "scheme" attribute. + + + + + The "scope" attribute. + + + + + The "scrolling" attribute. + + + + + The "selected" attribute. + + + + + The "shape" attribute. + + + + + The "size" attribute. + + + + + The "span" attribute. + + + + + The "src" attribute. + + + + + The "standby" attribute. + + + + + The "start" attribute. + + + + + The "style" attribute. + + + + + The "summary" attribute. + + + + + The "tabindex" attribute. + + + + + The "target" attribute. + + + + + The "text" attribute. + + + + + The "title" attribute. + + + + + The "topmargin" attribute. + + + + + The "type" attribute. + + + + + The "usemap" attribute. + + + + + The "valign" attribute. + + + + + The "value" attribute. + + + + + The "valuetype" attribute. + + + + + The "version" attribute. + + + + + The "vlink" attribute. + + + + + The "vspace" attribute. + + + + + The "width" attribute. + + + + + The "xmlns" attribute. + + + + + extension methods. + + + extension methods. + + + + + Converts the enum value into the equivalent attribute name. + + + Converts the enum value into the equivalent attribute name. + + The attribute name. + The enum value. + + + + Converts the attribute name into the equivalent attribute id. + + + Converts the attribute name into the equivalent attribute id. + + The attribute id. + The attribute name. + + + + An HTML entity decoder. + + + An HTML entity decoder. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Push the specified character into the HTML entity decoder. + + + Pushes the specified character into the HTML entity decoder. + The first character pushed MUST be the '&' character. + + true if the character was accepted; otherwise, false. + The character. + + is the first character being pushed and was not the '&' character. + + + + + Get the decoded entity value. + + + Gets the decoded entity value. + + The value. + + + + Reset the entity decoder. + + + Resets the entity decoder. + + + + + An HTML namespace. + + + An HTML namespace. + + + + + The namespace is "http://www.w3.org/1999/xhtml". + + + + + The namespace is "http://www.w3.org/1998/Math/MathML". + + + + + The namespace is "http://www.w3.org/2000/svg". + + + + + The namespace is "http://www.w3.org/1999/xlink". + + + + + The namespace is "http://www.w3.org/XML/1998/namespace". + + + + + The namespace is "http://www.w3.org/2000/xmlns/". + + + + + extension methods. + + + extension methods. + + + + + Converts the enum value into the equivalent namespace url. + + + Converts the enum value into the equivalent namespace url. + + The tag name. + The enum value. + + + + Convert the tag name into the equivalent tag id. + + + Converts the tag name into the equivalent tag id. + + The tag id. + The namespace. + + + + An HTML tag callback delegate. + + + The delegate is called when a converter + is ready to write a new HTML tag, allowing developers to customize + whether the tag gets written at all, which attributes get written, etc. + + + + + The HTML tag context. + The HTML writer. + + + + An HTML tag context. + + + An HTML tag context used with the delegate. + + + + + + + + Initialize a new instance of the class. + + + Creates a new . + + The HTML tag identifier. + + is invalid. + + + + + Get the HTML tag attributes. + + + Gets the HTML tag attributes. + + + + + The attributes. + + + + Get or set whether or not the end tag should be deleted. + + + Gets or sets whether or not the end tag should be deleted. + + true if the end tag should be deleted; otherwise, false. + + + + Get or set whether or not the tag should be deleted. + + + Gets or sets whether or not the tag should be deleted. + + true if the tag should be deleted; otherwise, false. + + + + Get or set whether or not the should be invoked for the end tag. + + + Gets or sets whether or not the should be invoked for the end tag. + + + + + true if the callback should be invoked for end tag; otherwise, false. + + + + Get whether or not the tag is an empty element. + + + Gets whether or not the tag is an empty element. + + + + + true if the tag is an empty element; otherwise, false. + + + + Get whether or not the tag is an end tag. + + + Gets whether or not the tag is an end tag. + + + + + true if the tag is an end tag; otherwise, false. + + + + Get or set whether or not the inner content of the tag should be suppressed. + + + Gets or sets whether or not the inner content of the tag should be suppressed. + + true if the inner content should be suppressed; otherwise, false. + + + + Get the HTML tag identifier. + + + Gets the HTML tag identifier. + + + + + The HTML tag identifier. + + + + Get the HTML tag name. + + + Gets the HTML tag name. + + + + + The HTML tag name. + + + + Write the HTML tag. + + + Writes the HTML tag to the given . + + The HTML writer. + + is null. + + + + + Write the HTML tag. + + + Writes the HTML tag to the given . + + + + + The HTML writer. + true if the should also be written; otherwise, false. + + is null. + + + + + HTML tag identifiers. + + + HTML tag identifiers. + + + + + + + + An unknown HTML tag identifier. + + + + + The HTML <a> tag. + + + + + The HTML <abbr> tag. + + + + + The HTML <acronym> tag. + + + + + The HTML <address> tag. + + + + + The HTML <applet> tag. + + + + + The HTML <area> tag. + + + + + The HTML <article> tag. + + + + + The HTML <aside> tag. + + + + + The HTML <audio> tag. + + + + + The HTML <b> tag. + + + + + The HTML <base> tag. + + + + + The HTML <basefont> tag. + + + + + The HTML <bdi> tag. + + + + + The HTML <bdo> tag. + + + + + The HTML <bgsound> tag. + + + + + The HTML <big> tag. + + + + + The HTML <blink> tag. + + + + + The HTML <blockquote> tag. + + + + + The HTML <body> tag. + + + + + The HTML <br> tag. + + + + + The HTML <button> tag. + + + + + The HTML <canvas> tag. + + + + + The HTML <caption> tag. + + + + + The HTML <center> tag. + + + + + The HTML <cite> tag. + + + + + The HTML <code> tag. + + + + + The HTML <col> tag. + + + + + The HTML <colgroup> tag. + + + + + The HTML <command> tag. + + + + + The HTML comment tag. + + + + + The HTML <datalist> tag. + + + + + The HTML <dd> tag. + + + + + The HTML <del> tag. + + + + + The HTML <details> tag. + + + + + The HTML <dfn> tag. + + + + + The HTML <dialog> tag. + + + + + The HTML <dir> tag. + + + + + The HTML <div> tag. + + + + + The HTML <dl> tag. + + + + + The HTML <dt> tag. + + + + + The HTML <em> tag. + + + + + The HTML <embed> tag. + + + + + The HTML <fieldset> tag. + + + + + The HTML <figcaption> tag. + + + + + The HTML <figure> tag. + + + + + The HTML <font> tag. + + + + + The HTML <footer> tag. + + + + + The HTML <form> tag. + + + + + The HTML <frame> tag. + + + + + The HTML <frameset> tag. + + + + + The HTML <h1> tag. + + + + + The HTML <h2> tag. + + + + + The HTML <h3> tag. + + + + + The HTML <h4> tag. + + + + + The HTML <h5> tag. + + + + + The HTML <h6> tag. + + + + + The HTML <head> tag. + + + + + The HTML <header> tag. + + + + + The HTML <hr> tag. + + + + + The HTML <html> tag. + + + + + The HTML <i> tag. + + + + + The HTML <iframe> tag. + + + + + The HTML <img> tag. + + + + + The HTML <input> tag. + + + + + The HTML <ins> tag. + + + + + The HTML <isindex> tag. + + + + + The HTML <kbd> tag. + + + + + The HTML <keygen> tag. + + + + + The HTML <label> tag. + + + + + The HTML <legend> tag. + + + + + The HTML <li> tag. + + + + + The HTML <link> tag. + + + + + The HTML <listing> tag. + + + + + The HTML <main> tag. + + + + + The HTML <map> tag. + + + + + The HTML <mark> tag. + + + + + The HTML <marquee> tag. + + + + + The HTML <menu> tag. + + + + + The HTML <menuitem> tag. + + + + + The HTML <meta> tag. + + + + + The HTML <meter> tag. + + + + + The HTML <nav> tag. + + + + + The HTML <nextid> tag. + + + + + The HTML <nobr> tag. + + + + + The HTML <noembed> tag. + + + + + The HTML <noframes> tag. + + + + + The HTML <noscript> tag. + + + + + The HTML <object> tag. + + + + + The HTML <ol> tag. + + + + + The HTML <optgroup> tag. + + + + + The HTML <option> tag. + + + + + The HTML <output> tag. + + + + + The HTML <p> tag. + + + + + The HTML <param> tag. + + + + + The HTML <plaintext> tag. + + + + + The HTML <pre> tag. + + + + + The HTML <progress> tag. + + + + + The HTML <q> tag. + + + + + The HTML <rp> tag. + + + + + The HTML <rt> tag. + + + + + The HTML <ruby> tag. + + + + + The HTML <s> tag. + + + + + The HTML <samp> tag. + + + + + The HTML <script> tag. + + + + + The HTML <section> tag. + + + + + The HTML <select> tag. + + + + + The HTML <small> tag. + + + + + The HTML <source> tag. + + + + + The HTML <span> tag. + + + + + The HTML <strike> tag. + + + + + The HTML <strong> tag. + + + + + The HTML <style> tag. + + + + + The HTML <sub> tag. + + + + + The HTML <summary> tag. + + + + + The HTML <sup> tag. + + + + + The HTML <table> tag. + + + + + The HTML <tbody> tag. + + + + + The HTML <td> tag. + + + + + The HTML <textarea> tag. + + + + + The HTML <tfoot> tag. + + + + + The HTML <th> tag. + + + + + The HTML <thead> tag. + + + + + The HTML <time> tag. + + + + + The HTML <title> tag. + + + + + The HTML <tr> tag. + + + + + The HTML <track> tag. + + + + + The HTML <tt> tag. + + + + + The HTML <u> tag. + + + + + The HTML <ul> tag. + + + + + The HTML <var> tag. + + + + + The HTML <video> tag. + + + + + The HTML <wbr> tag. + + + + + The HTML <xml> tag. + + + + + The HTML <xmp> tag. + + + + + extension methods. + + + extension methods. + + + + + Converts the enum value into the equivalent tag name. + + + Converts the enum value into the equivalent tag name. + + The tag name. + The enum value. + + + + Converts the tag name into the equivalent tag id. + + + Converts the tag name into the equivalent tag id. + + The tag id. + The tag name. + + + + Determines whether or not the HTML tag is an empty element. + + + Determines whether or not the HTML tag is an empty element. + + true if the tag is an empty element; otherwise, false. + Identifier. + + + + Determines whether or not the HTML tag is a formatting element. + + + Determines whether or not the HTML tag is a formatting element. + + true if the HTML tag is a formatting element; otherwise, false. + The HTML tag identifier. + + + + A text previewer for HTML content. + + + A text previewer for HTML content. + + + + + Initialize a new instance of the class. + + + Creates a new previewer for HTML. + + + + + Get the input format. + + + Gets the input format. + + The input format. + + + + Get a text preview of a stream of text. + + + Gets a text preview of a stream of text. + + The original text stream. + A string representing a shortened preview of the original text. + + is null. + + + + + An HTML to HTML converter. + + + Used to convert HTML into HTML. + + + + + + + + Initialize a new instance of the class. + + + Creates a new HTML to HTML converter. + + + + + Get the input format. + + + Gets the input format. + + The input format. + + + + Get the output format. + + + Gets the output format. + + The output format. + + + + Get or set whether or not the converter should remove HTML comments from the output. + + + Gets or sets whether or not the converter should remove HTML comments from the output. + + true if the converter should remove comments; otherwise, false. + + + + Get or set whether or not executable scripts should be stripped from the output. + + + Gets or sets whether or not executable scripts should be stripped from the output. + + true if executable scripts should be filtered; otherwise, false. + + + + Get or set the footer format. + + + Gets or sets the footer format. + + The footer format. + + + + Get or set the header format. + + + Gets or sets the header format. + + The header format. + + + + Get or set the method to use for custom + filtering of HTML tags and content. + + + Get or set the method to use for custom + filtering of HTML tags and content. + + + + + The html tag callback. + + + + Convert the contents of from the to the + and uses the to write the resulting text. + + + Converts the contents of from the to the + and uses the to write the resulting text. + + The text reader. + The text writer. + + is null. + -or- + is null. + + + + + An abstract HTML token class. + + + An abstract HTML token class. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The kind of token. + + + + Get the kind of HTML token that this object represents. + + + Gets the kind of HTML token that this object represents. + + The kind of token. + + + + Write the HTML token to a . + + + Writes the HTML token to a . + + The output. + + is null. + + + + + Return a that represents the current . + + + Returns a that represents the current . + + A that represents the current . + + + + An HTML comment token. + + + An HTML comment token. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The comment text. + true if the comment is bogus; otherwise, false. + + is null. + + + + + Get the comment. + + + Gets the comment. + + The comment. + + + + Get whether or not the comment is a bogus comment. + + + Gets whether or not the comment is a bogus comment. + + true if the comment is bogus; otherwise, false. + + + + Write the HTML comment to a . + + + Writes the HTML comment to a . + + The output. + + is null. + + + + + An HTML token constisting of character data. + + + An HTML token consisting of character data. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The kind of character data. + The character data. + + is not a valid . + + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The character data. + + is null. + + + + + Get the character data. + + + Gets the character data. + + The character data. + + + + Write the HTML character data to a . + + + Writes the HTML character data to a , + encoding it if it isn't already encoded. + + The output. + + is null. + + + + + An HTML token constisting of [CDATA[. + + + An HTML token consisting of [CDATA[. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The character data. + + is null. + + + + + Write the HTML character data to a . + + + Writes the HTML character data to a , + encoding it if it isn't already encoded. + + The output. + + is null. + + + + + An HTML token constisting of script data. + + + An HTML token consisting of script data. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The script data. + + is null. + + + + + Write the HTML script data to a . + + + Writes the HTML script data to a , + encoding it if it isn't already encoded. + + The output. + + is null. + + + + + An HTML tag token. + + + An HTML tag token. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The name of the tag. + The attributes. + true if the tag is an empty element; otherwise, false. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The name of the tag. + true if the tag is an end tag; otherwise, false. + + is null. + + + + + Get the attributes. + + + Gets the attributes. + + The attributes. + + + + Get the HTML tag identifier. + + + Gets the HTML tag identifier. + + The HTML tag identifier. + + + + Get whether or not the tag is an empty element. + + + Gets whether or not the tag is an empty element. + + true if the tag is an empty element; otherwise, false. + + + + Get whether or not the tag is an end tag. + + + Gets whether or not the tag is an end tag. + + true if the tag is an end tag; otherwise, false. + + + + Get the name of the tag. + + + Gets the name of the tag. + + The name. + + + + Write the HTML tag to a . + + + Writes the HTML tag to a . + + The output. + + is null. + + + + + An HTML DOCTYPE token. + + + An HTML DOCTYPE token. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Get whether or not quirks-mode should be forced. + + + Gets whether or not quirks-mode should be forced. + + true if quirks-mode should be forced; otherwise, false. + + + + Get or set the DOCTYPE name. + + + Gets or sets the DOCTYPE name. + + The name. + + + + Get or set the public identifier. + + + Gets or sets the public identifier. + + The public identifier. + + + + Get the public keyword that was used. + + + Gets the public keyword that was used. + + The public keyword or null if it wasn't used. + + + + Get or set the system identifier. + + + Gets or sets the system identifier. + + The system identifier. + + + + Get the system keyword that was used. + + + Gets the system keyword that was used. + + The system keyword or null if it wasn't used. + + + + Write the DOCTYPE tag to a . + + + Writes the DOCTYPE tag to a . + + The output. + + is null. + + + + + An HTML tokenizer. + + + Tokenizes HTML text, emitting an for each token it encounters. + + + + + Initialize a new instance of the class. + + + Creates a new . + This constructor will attempt to auto-detect the appropriate encoding to use by examining the first four bytes of the stream + and, if a unicode byte-order-mark is detected, use the appropriate unicode encoding. If no byte order mark is detected, then it will + default to UTF-8. + + The input stream. + + + + Initialize a new instance of the class. + + + Creates a new . + This constructor will attempt to auto-detect the appropriate encoding to use by examining the first four bytes of the stream + and, if a unicode byte-order-mark is detected, use the appropriate unicode encoding. If no byte order mark is detected, then it will + default to the user-supplied encoding. + + The input stream. + The charset encoding of the stream. + + + + Initialize a new instance of the class. + + + Creates a new . + This constructor allows you to change the encoding the first time you read from the . The + parameter detects the encoding by looking at the first four bytes of the stream. + It will automatically recognize UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32, and big-endian UTF-32 text if + the stream starts with the appropriate byte order marks. Otherwise, the user-provided encoding is used. + + The input stream. + The charset encoding of the stream. + true if byte order marks should be detected and used to override the ; otherwise, false. + The minimum buffer size to use for reading. + + + + Initialize a new instance of the class. + + + Creates a new . + + The . + + + + Get or set whether or not the tokenizer should decode character references. + + + Gets or sets whether or not the tokenizer should decode character references. + Character references in attribute values will still be decoded + even if this value is set to false. + + true if character references should be decoded; otherwise, false. + + + + Get the current HTML namespace detected by the tokenizer. + + + Gets the current HTML namespace detected by the tokenizer. + + The html namespace. + + + + Get or set whether or not the tokenizer should ignore truncated tags. + + + Gets or sets whether or not the tokenizer should ignore truncated tags. + If false and the stream abruptly ends in the middle of an HTML tag, it will be + treated as an instead. + + true if truncated tags should be ignored; otherwise, false. + + + + Get the current line number. + + + This property is most commonly used for error reporting, but can be called + at any time. The starting value for this property is 1. + Combined with , a value of 1,1 indicates + the start of the document. + + The current line number. + + + + Get the current line position. + + + This property is most commonly used for error reporting, but can be called + at any time. The starting value for this property is 1. + Combined with , a value of 1,1 indicates + the start of the document. + + The column position of the current line. + + + + Get the current state of the tokenizer. + + + Gets the current state of the tokenizer. + + The current state of the tokenizer. + + + + Create a DOCTYPE token. + + + Creates a DOCTYPE token. + + The DOCTYPE token. + + + + Create an HTML comment token. + + + Creates an HTML comment token. + + The HTML comment token. + The comment. + true if the comment is bogus; otherwise, false. + + + + Create an HTML character data token. + + + Creates an HTML character data token. + + The HTML character data token. + The character data. + + + + Create an HTML character data token. + + + Creates an HTML character data token. + + The HTML character data token. + The character data. + + + + Create an HTML script data token. + + + Creates an HTML script data token. + + The HTML script data token. + The script data. + + + + Create an HTML tag token. + + + Creates an HTML tag token. + + The HTML tag token. + The tag name. + true if the tag is an end tag; otherwise, false. + + + + Create an attribute. + + + Creates an attribute. + + The attribute. + The attribute name. + + + + Read the next token. + + + Reads the next token. + + true if the next token was read; otherwise, false. + The token that was read. + + + + The HTML tokenizer state. + + + The HTML tokenizer state. + + + + + The data state as described at + + http://www.w3.org/TR/html5/syntax.html#data-state. + + + + + The character reference in data state as described at + + http://www.w3.org/TR/html5/syntax.html#character-reference-in-data-state. + + + + + The RCDATA state as described at + + http://www.w3.org/TR/html5/syntax.html#rcdata-state. + + + + + The character reference in RCDATA state as described at + + http://www.w3.org/TR/html5/syntax.html#character-reference-in-rcdata-state. + + + + + The RAWTEXT state as described at + + http://www.w3.org/TR/html5/syntax.html#rawtext-state. + + + + + The script data state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-state. + + + + + The PLAINTEXT state as described at + + http://www.w3.org/TR/html5/syntax.html#plaintext-state. + + + + + The tag open state as described at + + http://www.w3.org/TR/html5/syntax.html#tag-open-state. + + + + + The end tag open state as described at + + http://www.w3.org/TR/html5/syntax.html#end-tag-open-state. + + + + + The tag name state as described at + + http://www.w3.org/TR/html5/syntax.html#tag-name-state. + + + + + The RCDATA less-than state as described at + + http://www.w3.org/TR/html5/syntax.html#rcdata-less-than-sign-state. + + + + + The RCDATA end tag open state as described at + + http://www.w3.org/TR/html5/syntax.html#rcdata-end-tag-open-state. + + + + + The RCDATA end tag name state as described at + + http://www.w3.org/TR/html5/syntax.html#rcdata-end-tag-name-state. + + + + + The RAWTEXT less-than state as described at + + http://www.w3.org/TR/html5/syntax.html#rawtext-less-than-sign-state. + + + + + The RAWTEXT end tag open state as described at + + http://www.w3.org/TR/html5/syntax.html#rawtext-end-tag-open-state. + + + + + The RAWTEXT end tag name state as described at + + http://www.w3.org/TR/html5/syntax.html#rawtext-end-tag-name-state. + + + + + The script data less-than state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-less-than-sign-state. + + + + + The script data end tag open state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-end-tag-open-state. + + + + + The script data end tag name state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-end-tag-name-state. + + + + + The script data escape start state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-escape-start-state. + + + + + The script data escape start state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-escape-start-dash-state. + + + + + The script data escaped state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-escaped-state. + + + + + The script data escaped dash state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-escaped-dash-state. + + + + + The script data escaped dash dash state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-escaped-dash-dash-state. + + + + + The script data escaped less-than state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-escaped-less-than-sign-state. + + + + + The script data escaped end tag open state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-escaped-end-tag-open-state. + + + + + The script data escaped end tag name state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-escaped-end-tag-name-state. + + + + + The script data double escape start state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-double-escape-start-state. + + + + + The script data double escaped state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-double-escaped-state. + + + + + The script data double escaped dash state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-double-escaped-dash-state. + + + + + The script data double escaped dash dash state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-double-escaped-dash-dash-state. + + + + + The script data double escaped less-than state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-double-escaped-less-than-sign-state. + + + + + The script data double escape end state as described at + + http://www.w3.org/TR/html5/syntax.html#script-data-double-escape-end-state. + + + + + The before attribute name state as described at + + http://www.w3.org/TR/html5/syntax.html#before-attribute-name-state. + + + + + The attribute name state as described at + + http://www.w3.org/TR/html5/syntax.html#attribute-name-state. + + + + + The after attribute name state as described at + + http://www.w3.org/TR/html5/syntax.html#after-attribute-name-state. + + + + + The beforw attribute value state as described at + + http://www.w3.org/TR/html5/syntax.html#before-attribute-value-state. + + + + + The attribute value quoted state as described at + + http://www.w3.org/TR/html5/syntax.html#attribute-value-(double-quoted)-state. + + + + + The attribute value unquoted state as described at + + http://www.w3.org/TR/html5/syntax.html#attribute-value-(unquoted)-state. + + + + + The character reference in attribute value state as described at + + http://www.w3.org/TR/html5/syntax.html#character-reference-in-attribute-value-state. + + + + + The after attribute value quoted state as described at + + http://www.w3.org/TR/html5/syntax.html#after-attribute-value-(quoted)-state. + + + + + The self-closing start tag state as described at + + http://www.w3.org/TR/html5/syntax.html#self-closing-start-tag-state. + + + + + The bogus comment state as described at + + http://www.w3.org/TR/html5/syntax.html#bogus-comment-state. + + + + + The markup declaration open state as described at + + http://www.w3.org/TR/html5/syntax.html#markup-declaration-open-state. + + + + + The comment start state as described at + + http://www.w3.org/TR/html5/syntax.html#comment-start-state. + + + + + The comment start dash state as described at + + http://www.w3.org/TR/html5/syntax.html#comment-start-dash-state. + + + + + The comment state as described at + + http://www.w3.org/TR/html5/syntax.html#comment-state. + + + + + The comment end dash state as described at + + http://www.w3.org/TR/html5/syntax.html#comment-end-dash-state. + + + + + The comment end state as described at + + http://www.w3.org/TR/html5/syntax.html#comment-end-state. + + + + + The comment end bang state as described at + + http://www.w3.org/TR/html5/syntax.html#comment-end-bang-state. + + + + + The DOCTYPE state as described at + + http://www.w3.org/TR/html5/syntax.html#doctype-state. + + + + + The before DOCTYPE name state as described at + + http://www.w3.org/TR/html5/syntax.html#before-doctype-name-state. + + + + + The DOCTYPE name state as described at + + http://www.w3.org/TR/html5/syntax.html#doctype-name-state. + + + + + The after DOCTYPE name state as described at + + http://www.w3.org/TR/html5/syntax.html#after-doctype-name-state. + + + + + The after DOCTYPE public keyword state as described at + + http://www.w3.org/TR/html5/syntax.html#after-doctype-public-keyword-state. + + + + + The before DOCTYPE public identifier state as described at + + http://www.w3.org/TR/html5/syntax.html#before-doctype-public-identifier-state. + + + + + The DOCTYPE public identifier quoted state as described at + + http://www.w3.org/TR/html5/syntax.html#doctype-public-identifier-(double-quoted)-state. + + + + + The after DOCTYPE public identifier state as described at + + http://www.w3.org/TR/html5/syntax.html#after-doctype-public-identifier-state. + + + + + The between DOCTYPE public and system identifiers state as described at + + http://www.w3.org/TR/html5/syntax.html#between-doctype-public-and-system-identifiers-state. + + + + + The after DOCTYPE system keyword state as described at + + http://www.w3.org/TR/html5/syntax.html#after-doctype-system-keyword-state. + + + + + The before DOCTYPE system identifier state as described at + + http://www.w3.org/TR/html5/syntax.html#before-doctype-system-identifier-state. + + + + + The DOCTYPE system identifier quoted state as described at + + http://www.w3.org/TR/html5/syntax.html#doctype-system-identifier-(double-quoted)-state. + + + + + The after DOCTYPE system identifier state as described at + + http://www.w3.org/TR/html5/syntax.html#after-doctype-system-identifier-state. + + + + + The bogus DOCTYPE state as described at + + http://www.w3.org/TR/html5/syntax.html#bogus-doctype-state. + + + + + The CDATA section state as described at + + http://www.w3.org/TR/html5/syntax.html#cdata-section-state. + + + + + The end of file state. + + + + + The kinds of tokens that the can emit. + + + The kinds of tokens that the can emit. + + + + + A token consisting of [CDATA[. + + + + + An HTML comment token. + + + + + A token consisting of character data. + + + + + An HTML DOCTYPE token. + + + + + A token consisting of script data. + + + + + An HTML tag token. + + + + + A collection of HTML-related utility methods. + + + A collection of HTML-related utility methods. + + + + + Encode an HTML attribute value. + + + Encodes an HTML attribute value. + + The to output the result. + The attribute value to encode. + The character to use for quoting the attribute value. + + is null. + -or- + is null. + + + is not a valid quote character. + + + + + Encode an HTML attribute value. + + + Encodes an HTML attribute value. + + The encoded attribute value. + The attribute value to encode. + The character to use for quoting the attribute value. + + is null. + + + is not a valid quote character. + + + + + Encode an HTML attribute value. + + + Encodes an HTML attribute value. + + The to output the result. + The attribute value to encode. + The starting index of the attribute value. + The number of characters in the attribute value. + The character to use for quoting the attribute value. + + is null. + -or- + is null. + + + and do not specify + a valid range in the value. + + + is not a valid quote character. + + + + + Encode an HTML attribute value. + + + Encodes an HTML attribute value. + + The encoded attribute value. + The attribute value to encode. + The starting index of the attribute value. + The number of characters in the attribute value. + The character to use for quoting the attribute value. + + is null. + + + and do not specify + a valid range in the value. + + + is not a valid quote character. + + + + + Encode an HTML attribute value. + + + Encodes an HTML attribute value. + + The to output the result. + The attribute value to encode. + The starting index of the attribute value. + The number of characters in the attribute value. + The character to use for quoting the attribute value. + + is null. + -or- + is null. + + + and do not specify + a valid range in the value. + + + is not a valid quote character. + + + + + Encode an HTML attribute value. + + + Encodes an HTML attribute value. + + The encoded attribute value. + The attribute value to encode. + The starting index of the attribute value. + The number of characters in the attribute value. + The character to use for quoting the attribute value. + + is null. + + + and do not specify + a valid range in the value. + + + is not a valid quote character. + + + + + Encode an HTML attribute value. + + + Encodes an HTML attribute value. + + The to output the result. + The attribute value to encode. + The character to use for quoting the attribute value. + + is null. + -or- + is null. + + + is not a valid quote character. + + + + + Encode an HTML attribute value. + + + Encodes an HTML attribute value. + + The encoded attribute value. + The attribute value to encode. + The character to use for quoting the attribute value. + + is null. + + + is not a valid quote character. + + + + + Encode HTML character data. + + + Encodes HTML character data. + + The to output the result. + The character data to encode. + + is null. + -or- + is null. + + + + + Encode HTML character data. + + + Encodes HTML character data. + + The encoded character data. + The character data to encode. + + is null. + + + + + Encode HTML character data. + + + Encodes HTML character data. + + The to output the result. + The character data to encode. + The starting index of the character data. + The number of characters in the data. + + is null. + -or- + is null. + + + and do not specify + a valid range in the data. + + + + + Encode HTML character data. + + + Encodes HTML character data. + + The encoded character data. + The character data to encode. + The starting index of the character data. + The number of characters in the data. + + is null. + + + and do not specify + a valid range in the data. + + + + + Encode HTML character data. + + + Encodes HTML character data. + + The to output the result. + The character data to encode. + The starting index of the character data. + The number of characters in the data. + + is null. + -or- + is null. + + + and do not specify + a valid range in the data. + + + + + Encode HTML character data. + + + Encodes HTML character data. + + The encoded character data. + The character data to encode. + The starting index of the character data. + The number of characters in the data. + + is null. + + + and do not specify + a valid range in the data. + + + + + Encode HTML character data. + + + Encodes HTML character data. + + The to output the result. + The character data to encode. + + is null. + -or- + is null. + + + + + Encode HTML character data. + + + Encodes HTML character data. + + The encoded character data. + The character data to encode. + + is null. + + + + + Decode HTML character data. + + + Decodes HTML character data. + + The to output the result. + The character data to decode. + The starting index of the character data. + The number of characters in the data. + + is null. + -or- + is null. + + + and do not specify + a valid range in the data. + + + + + Decode HTML character data. + + + Decodes HTML character data. + + The to output the result. + The character data to decode. + + is null. + -or- + is null. + + + + + Decode HTML character data. + + + Decodes HTML character data. + + The decoded character data. + The character data to decode. + The starting index of the character data. + The number of characters in the data. + + is null. + + + and do not specify + a valid range in the data. + + + + + Decode HTML character data. + + + Decodes HTML character data. + + The decoded character data. + The character data to decode. + + is null. + + + + + An HTML writer. + + + An HTML writer. + + + + + + + + Initialize a new instance of the class. + + + Creates a new . + + The output stream. + The encoding to use for the output. + + is null. + -or- + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The output text writer. + + is null. + + + + + Release unmanaged resources and perform other cleanup operations before the + is reclaimed by garbage collection. + + + Releases unmanaged resources and performs other cleanup operations before the + is reclaimed by garbage collection. + + + + + Get the current state of the writer. + + + Gets the current state of the writer. + + The state of the writer. + + + + Write the attribute to the output stream. + + + Writes the attribute to the output stream. + + The attribute identifier. + A buffer containing the attribute value. + The starting index of the attribute value. + The number of characters in the attribute value. + + is not a valid HTML attribute identifier. + + + is null. + + + is less than zero or greater than the length of + . + -or- + and do not specify + a valid range in the . + + + The is not in a state that allows writing attributes. + + + The has been disposed. + + + + + Write the attribute to the output stream. + + + Writes the attribute to the output stream. + + The attribute name. + A buffer containing the attribute value. + The starting index of the attribute value. + The number of characters in the attribute value. + + is null. + -or- + is null. + + + is less than zero or greater than the length of + . + -or- + and do not specify + a valid range in the . + + + is an invalid attribute name. + + + The is not in a state that allows writing attributes. + + + The has been disposed. + + + + + Write the attribute to the output stream. + + + Writes the attribute to the output stream. + + + + + The attribute identifier. + The attribute value. + + is not a valid HTML attribute identifier. + + + is null. + + + The is not in a state that allows writing attributes. + + + The has been disposed. + + + + + Write the attribute to the output stream. + + + Writes the attribute to the output stream. + + + + + The attribute name. + The attribute value. + + is null. + -or- + is null. + + + is an invalid attribute name. + + + The is not in a state that allows writing attributes. + + + The has been disposed. + + + + + Write the attribute to the output stream. + + + Writes the attribute to the output stream. + + + + + The attribute. + + is null. + + + The is not in a state that allows writing attributes. + + + The has been disposed. + + + + + Write the attribute name to the output stream. + + + Writes the attribute name to the output stream. + + The attribute identifier. + + is not a valid HTML attribute identifier. + + + The is not in a state that allows writing attributes. + + + The has been disposed. + + + + + Write the attribute name to the output stream. + + + Writes the attribute name to the output stream. + + + + + The attribute name. + + is null. + + + is an invalid attribute name. + + + The is not in a state that allows writing attributes. + + + The has been disposed. + + + + + Write the attribute value to the output stream. + + + Writes the attribute value to the output stream. + + A buffer containing the attribute value. + The starting index of the attribute value. + The number of characters in the attribute value. + + is null. + + + is less than zero or greater than the length of + . + -or- + and do not specify + a valid range in the . + + + The is not in a state that allows writing attribute values. + + + The has been disposed. + + + + + Write the attribute value to the output stream. + + + Writes the attribute value to the output stream. + + + + + The attribute value. + + is null. + + + The is not in a state that allows writing attribute values. + + + The has been disposed. + + + + + Write an empty element tag. + + + Writes an empty element tag. + + The HTML tag identifier. + + is not a valid HTML tag identifier. + + + The has been disposed. + + + + + Write an empty element tag. + + + Writes an empty element tag. + + The name of the HTML tag. + + is null. + + + is not a valid HTML tag. + + + The has been disposed. + + + + + Write an end tag. + + + Writes an end tag. + + + + + The HTML tag identifier. + + is not a valid HTML tag identifier. + + + The has been disposed. + + + + + Write an end tag. + + + Writes an end tag. + + The name of the HTML tag. + + is null. + + + is not a valid HTML tag. + + + The has been disposed. + + + + + Write a buffer containing HTML markup directly to the output, without escaping special characters. + + + Writes a buffer containing HTML markup directly to the output, without escaping special characters. + + The buffer containing HTML markup. + The index of the first character to write. + The number of characters to write. + + is null. + + + is less than zero or greater than the length of + . + -or- + and do not specify + a valid range in the . + + + The has been disposed. + + + + + Write a string containing HTML markup directly to the output, without escaping special characters. + + + Writes a string containing HTML markup directly to the output, without escaping special characters. + + The string containing HTML markup. + + is null. + + + The has been disposed. + + + + + Write a start tag. + + + Writes a start tag. + + + + + The HTML tag identifier. + + is not a valid HTML tag identifier. + + + The has been disposed. + + + + + Write a start tag. + + + Writes a start tag. + + The name of the HTML tag. + + is null. + + + is not a valid HTML tag. + + + The has been disposed. + + + + + Write text to the output stream, escaping special characters. + + + Writes text to the output stream, escaping special characters. + + The text buffer. + The index of the first character to write. + The number of characters to write. + + is null. + + + is less than zero or greater than the length of + . + -or- + and do not specify + a valid range in the . + + + The has been disposed. + + + + + Write text to the output stream, escaping special characters. + + + Writes text to the output stream, escaping special characters. + + + + + The text. + + is null. + + + The has been disposed. + + + + + Write text to the output stream, escaping special characters. + + + Writes text to the output stream, escaping special characters. + + A composit format string. + An object array that contains zero or more objects to format. + + is null. + -or- + is null. + + + The has been disposed. + + + + + Write a token to the output stream. + + + Writes a token that was emitted by the + to the output stream. + + The HTML token. + + is null. + + + The has been disposed. + + + + + Flush any remaining state to the output stream. + + + Flushes any remaining state to the output stream. + + + The has been disposed. + + + + + Release the unmanaged resources used by the and + optionally releases the managed resources. + + + Releases any unmanaged resources used by the and + optionally releases the managed resources. + + true to release both managed and unmanaged resources; + false to release only the unmanaged resources. + + + + Release all resource used by the object. + + Call when you are finished using the . The + method leaves the in an unusable state. After calling + , you must release all references to the so the garbage + collector can reclaim the memory that the was occupying. + + + + An enumeration of possible states of a . + + + An enumeration of possible states of a . + + + + + The is not within a tag. In this state, the + can only write a tag or text. + + + + + The is inside a tag but has not started to write an attribute. In this + state, the can write an attribute, another tag, or text. + + + + + The is inside an attribute. In this state, the + can append a value to the current attribute, start the next attribute, or write another tag or text. + + + + + A text previewer for plain text. + + + A text previewer for plain text. + + + + + Initialize a new instance of the class. + + + Creates a new previewer for plain text. + + + + + Get the input format. + + + Gets the input format. + + The input format. + + + + Get a text preview of a string of text. + + + Gets a text preview of a string of text. + + The original text. + A string representing a shortened preview of the original text. + + is null. + + + + + Get a text preview of a stream of text. + + + Gets a text preview of a stream of text. + + The original text stream. + A string representing a shortened preview of the original text. + + is null. + + + + + An abstract class for converting text from one format to another. + + + An abstract class for converting text from one format to another. + + + + + + + + Initialize a new instance of the class. + + + Initialize a new instance of the class. + + + + + Get or set whether the encoding of the input is detected from the byte order mark or + determined by the property. + + + Gets or sets whether the encoding of the input is detected from the byte order mark or + determined by the property. + + true if detect encoding from byte order mark; otherwise, false. + + + + Get or set the input encoding. + + + Gets or sets the input encoding. + + The input encoding. + + is null. + + + + + Get the input format. + + + Gets the input format. + + The input format. + + + + Get or set the output encoding. + + + Gets or sets the output encoding. + + The output encoding. + + is null. + + + + + Get the output format. + + + Gets the output format. + + The output format. + + + + Get or set the size of the input stream buffer. + + + Gets or sets the size of the input stream buffer. + + The size of the input stream buffer. + + is less than or equal to 0. + + + + + Get or set the size of the output stream buffer. + + + Gets or sets the size of the output stream buffer. + + The size of the output stream buffer. + + is less than or equal to 0. + + + + + Get or set the text that will be appended to the end of the output. + + + Gets or sets the text that will be appended to the end of the output. + The footer must be set before conversion begins. + + The footer. + + + + Get or set text that will be prepended to the beginning of the output. + + + Gets or sets the text that will be prepended to the beginning of the output. + The header must be set before conversion begins. + + The header. + + + + Convert the contents of from the to the + and writes the resulting text to . + + + Converts the contents of from the to the + and writes the resulting text to . + + The source stream. + The destination stream. + + is null. + -or- + is null. + + + + + Convert the contents of from the to the + and uses the to write the resulting text. + + + Converts the contents of from the to the + and uses the to write the resulting text. + + The source stream. + The text writer. + + is null. + -or- + is null. + + + + + Convert the contents of from the to the + and writes the resulting text to . + + + Converts the contents of from the to the + and writes the resulting text to . + + The text reader. + The destination stream. + + is null. + -or- + is null. + + + + + Convert the contents of from the to the + and uses the to write the resulting text. + + + Converts the contents of from the to the + and uses the to write the resulting text. + + The text reader. + The text writer. + + is null. + -or- + is null. + + + + + Convert text from the to the . + + + Converts text from the to the . + + + + + The converted text. + The text to convert. + + is null. + + + + + An enumeration of text encoding confidences. + + + An enumeration of text encoding confidences. + + + + + The text encoding confidence is undefined. + + + + + The text encoding confidence is tentative. + + + + + The text encoding confidence is certain. + + + + + The text encoding confidence is irrelevant. + + + + + An enumeration of text formats. + + + An enumeration of text formats. + + + + + The plain text format. + + + + + An alias for the plain text format. + + + + + The flowed text format (as described in rfc3676). + + + + + The HTML text format. + + + + + The enriched text format. + + + + + The compressed rich text format. + + + + + The rich text format. + + + + + An abstract class for generating a text preview of a message. + + + An abstract class for generating a text preview of a message. + + + + + Initialize a new instance of the class. + + + Initialize a new instance of the class. + + + + + Get the input format. + + + Gets the input format. + + The input format. + + + + Get or set the maximum text preview length. + + + Gets or sets the maximum text preview length. + The default value is 230 which is what the GMail web API seems to use. + + The maximum text preview length. + + is less than 1 or greater than 1024. + + + + + Get a text preview of the text part. + + + Gets a text preview of the text part. + + The text part. + A string representing a shortened preview of the original text. + + is null. + + + + + Get a text preview of a string of text. + + + Gets a text preview of a string of text. + + The original text. + A string representing a shortened preview of the original text. + + is null. + + + + + Get a text preview of a stream of text in the specified charset. + + + Get a text preview of a stream of text in the specified charset. + + The original text stream. + The charset encoding of the stream. + A string representing a shortened preview of the original text. + + is null. + -or- + is null. + + + + + Get a text preview of a stream of text in the specified encoding. + + + Get a text preview of a stream of text in the specified encoding. + + The original text stream. + The encoding of the stream. + A string representing a shortened preview of the original text. + + is null. + -or- + is null. + + + + + Get a text preview of a stream of text. + + + Gets a text preview of a stream of text. + + The original text stream. + A string representing a shortened preview of the original text. + + is null. + + + + + A text to flowed text converter. + + + Wraps text to conform with the flowed text format described in rfc3676. + The Content-Type header for the wrapped output text should be set to + text/plain; format=flowed; delsp=yes. + + + + + Initialize a new instance of the class. + + + Creates a new text to flowed text converter. + + + + + Get the input format. + + + Gets the input format. + + The input format. + + + + Get the output format. + + + Gets the output format. + + The output format. + + + + Convert the contents of from the to the + and uses the to write the resulting text. + + + Converts the contents of from the to the + and uses the to write the resulting text. + + The text reader. + The text writer. + + is null. + -or- + is null. + + + + + A text to HTML converter. + + + Used to convert plain text into HTML. + + + + + + + + Initialize a new instance of the class. + + + Creates a new text to HTML converter. + + + + + Get the input format. + + + Gets the input format. + + The input format. + + + + Get the output format. + + + Gets the output format. + + The output format. + + + + Get or set the footer format. + + + Gets or sets the footer format. + + The footer format. + + + + Get or set the header format. + + + Gets or sets the header format. + + The header format. + + + + Get or set the method to use for custom + filtering of HTML tags and content. + + + Get or set the method to use for custom + filtering of HTML tags and content. + + The html tag callback. + + + + Get or set whether or not the converter should only output an HTML fragment. + + + Gets or sets whether or not the converter should only output an entire + HTML document or just a fragment of the HTML body content. + + true if the converter should only output an HTML fragment; otherwise, false. + + + + Convert the contents of from the to the + and uses the to write the resulting text. + + + Converts the contents of from the to the + and uses the to write the resulting text. + + The text reader. + The text writer. + + is null. + -or- + is null. + + + + + A text to text converter. + + + A text to text converter. + + + + + Initialize a new instance of the class. + + + Creates a new text to text converter. + + + + + Get the input format. + + + Gets the input format. + + The input format. + + + + Get the output format. + + + Gets the output format. + + The output format. + + + + Convert the contents of from the to the + and uses the to write the resulting text. + + + Converts the contents of from the to the + and uses the to write the resulting text. + + The text reader. + The text writer. + + is null. + -or- + is null. + + + + + An Aho-Corasick Trie graph. + + + An Aho-Corasick Trie graph. + + + + + Initialize a new instance of the class. + + + Creates a new . + + true if searching should ignore case; otherwise, false. + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Add a search pattern. + + + Adds the specified search pattern. + + The search pattern. + + is null. + + + cannot be an empty string. + + + + + Search the text for any of the patterns added to the trie. + + + Searches the text for any of the patterns added to the trie. + + The first index of a matched pattern if successful; otherwise, -1. + The text to search. + The starting index of the text. + The number of characters to search, starting at . + The pattern that was matched. + + is null. + + + and do not specify + a valid range in the string. + + + + + Search the text for any of the patterns added to the trie. + + + Searches the text for any of the patterns added to the trie. + + The first index of a matched pattern if successful; otherwise, -1. + The text to search. + The starting index of the text. + The pattern that was matched. + + is null. + + + is out of range. + + + + + Search the text for any of the patterns added to the trie. + + + Searches the text for any of the patterns added to the trie. + + The first index of a matched pattern if successful; otherwise, -1. + The text to search. + The pattern that was matched. + + is null. + + + + + An interface for a MIME part containing Microsoft TNEF data. + + + Represents an application/ms-tnef or application/vnd.ms-tnef part. + TNEF (Transport Neutral Encapsulation Format) attachments are most often + sent by Microsoft Outlook clients. + + + + + Convert the TNEF content into a . + + + TNEF data often contains properties that map to + headers. TNEF data also often contains file attachments which will be + mapped to MIME parts. + + A message representing the TNEF data in MIME format. + + The property is null. + + + The has been disposed. + + + + + Extract the embedded attachments from the TNEF data. + + + Parses the TNEF data and extracts all of the embedded file attachments. + + The attachments. + + The property is null. + + + The has been disposed. + + + + + A filter to decompress a compressed RTF stream. + + + Used to decompress a compressed RTF stream. + + + + + Initialize a new instance of the class. + + + Creates a new converter filter. + + + + + Get the compression mode. + + + At least 12 bytes from the stream must be processed before this property value will + be accurate. + + The compression mode. + + + + Get a value indicating whether the crc32 is valid. + + + Until all data has been processed, this property will always return false. + + true if the crc32 is valid; otherwise, false. + + + + Filter the specified input. + + Filters the specified input buffer starting at the given index, + spanning across the specified number of bytes. + The filtered output. + The input buffer. + The starting index of the input buffer. + Length. + Output index. + Output length. + If set to true flush. + + + + Reset the filter. + + + Resets the filter. + + + + + A RTF compression mode. + + + A RTF compression mode. + + + + + The compression mode is not known. + + + + + The RTF stream is not compressed. + + + + + The RTF stream is compressed. + + + + + The TNEF attach flags. + + + The enum contains a list of possible values for + the property. + + + + + No AttachFlags set. + + + + + The attachment is invisible in HTML bodies. + + + + + The attachment is invisible in RTF bodies. + + + + + The attachment is referenced (and rendered) by the HTML body. + + + + + The TNEF attach method. + + + The enum contains a list of possible values for + the property. + + + + + No AttachMethod specified. + + + + + The attachment is a binary blob and SHOULD appear in the + attribute. + + + + + The attachment is an embedded TNEF message stream and MUST appear + in the property of the + attribute. + + + + + The attachment is an OLE stream and MUST appear + in the property of the + attribute. + + + + + A TNEF attribute level. + + + A TNEF attribute level. + + + + + The attribute is a message-level attribute. + + + + + The attribute is an attachment-level attribute. + + + + + A TNEF attribute tag. + + + A TNEF attribute tag. + + + + + A Null TNEF attribute. + + + + + The Owner TNEF attribute. + + + + + The SentFor TNEF attribute. + + + + + The Delegate TNEF attribute. + + + + + The OriginalMessageClass TNEF attribute. + + + + + The DateStart TNEF attribute. + + + + + The DateEnd TNEF attribute. + + + + + The AidOwner TNEF attribute. + + + + + The RequestResponse TNEF attribute. + + + + + The From TNEF attribute. + + + + + The Subject TNEF attribute. + + + + + The DateSent TNEF attribute. + + + + + The DateReceived TNEF attribute. + + + + + The MessageStatus TNEF attribute. + + + + + The MessageClass TNEF attribute. + + + + + The MessageId TNEF attribute. + + + + + The ParentId TNEF attribute. + + + + + The ConversationId TNEF attribute. + + + + + The Body TNEF attribute. + + + + + The Priority TNEF attribute. + + + + + The AttachData TNEF attribute. + + + + + The AttachTitle TNEF attribute. + + + + + The AttachMetaFile TNEF attribute. + + + + + The AttachCreateDate TNEF attribute. + + + + + The AttachModifyDate TNEF attribute. + + + + + The DateModified TNEF attribute. + + + + + The AttachTransportFilename TNEF attribute. + + + + + The AttachRenderData TNEF attribute. + + + + + The MapiProperties TNEF attribute. + + + + + The RecipientTable TNEF attribute. + + + + + The Attachment TNEF attribute. + + + + + The TnefVersion TNEF attribute. + + + + + The OemCodepage TNEF attribute. + + + + + A TNEF compliance mode. + + + A TNEF compliance mode. + + + + + Use a loose compliance mode, attempting to ignore invalid or corrupt data. + + + + + Use a very strict compliance mode, aborting the parser at the first sign of + invalid or corrupted data. + + + + + A bitfield of potential TNEF compliance issues. + + + A bitfield of potential TNEF compliance issues. + + + + + The TNEF stream has no errors. + + + + + The TNEF stream has too many attributes. + + + + + The TNEF stream has one or more invalid attributes. + + + + + The TNEF stream has one or more attributes with invalid checksums. + + + + + The TNEF stream has one more more attributes with an invalid length. + + + + + The TNEF stream has one or more attributes with an invalid level. + + + + + The TNEF stream has one or more attributes with an invalid value. + + + + + The TNEF stream has one or more attributes with an invalid date value. + + + + + The TNEF stream has one or more invalid MessageClass attributes. + + + + + The TNEF stream has one or more invalid MessageCodepage attributes. + + + + + The TNEF stream has one or more invalid property lengths. + + + + + The TNEF stream has one or more invalid row counts. + + + + + The TNEF stream has an invalid signature value. + + + + + The TNEF stream has an invalid version value. + + + + + The TNEF stream is nested too deeply. + + + + + The TNEF stream is truncated. + + + + + The TNEF stream has one or more unsupported property types. + + + + + A TNEF exception. + + + A occurs when when a TNEF stream is found to be + corrupted and cannot be read any futher. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The serialization info. + The stream context. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new . + + The compliance status error. + The error message. + The inner exception. + + + + Initialize a new instance of the class. + + + Creates a new . + + The compliance status error. + The error message. + + + + When overridden in a derived class, sets the + with information about the exception. + + + Sets the + with information about the exception. + + The serialization info. + The streaming context. + + is null. + + + + + Get the error. + + + Gets the error. + + The error. + + + + A TNEF name identifier. + + + A TNEF name identifier. + + + + + Get the property set GUID. + + + Gets the property set GUID. + + The property set GUID. + + + + Get the kind of TNEF name identifier. + + + Gets the kind of TNEF name identifier. + + The kind of identifier. + + + + Get the name, if available. + + + If the is , then this property will be available. + + The name. + + + + Get the identifier, if available. + + + If the is , then this property will be available. + + The identifier. + + + + Initialize a new instance of the struct. + + + Creates a new with the specified integer identifier. + + The property set GUID. + The identifier. + + + + Initialize a new instance of the struct. + + + Creates a new with the specified string identifier. + + The property set GUID. + The name. + + + + Serves as a hash function for a object. + + + Serves as a hash function for a object. + + A hash code for this instance that is suitable for use in hashing algorithms + and data structures such as a hash table. + + + + Determine whether the specified is equal to the current . + + + 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. + + + + Determine whether the specified is equal to the current . + + + Compares two TNEF name identifiers to determine if they are identical or not. + + The to compare with the current . + true if the specified is equal to the current + ; otherwise, false. + + + + Compare two objects for equality. + + + Compares two objects for equality. + + The first object to compare. + The second object to compare. + true if and are equal; otherwise, false. + + + + Compare two objects for inequality. + + + Compares two objects for inequality. + + The first object to compare. + The second object to compare. + true if and are unequal; otherwise, false. + + + + The kind of TNEF name identifier. + + + The kind of TNEF name identifier. + + + + + The property name is an integer. + + + + + The property name is a string. + + + + + A MIME part containing Microsoft TNEF data. + + + Represents an application/ms-tnef or application/vnd.ms-tnef part. + TNEF (Transport Neutral Encapsulation Format) attachments are most often + sent by Microsoft Outlook clients. + + + + + Initialize a new instance of the class. + + + This constructor is used by . + + Information used by the constructor. + + is null. + + + + + Initialize a new instance of the class. + + + Creates a new with a Content-Type of application/vnd.ms-tnef + and a Content-Disposition value of "attachment" and a filename paremeter with a + value of "winmail.dat". + + + + + Dispatches to the specific visit method for this MIME entity. + + + This default implementation for nodes + calls . Override this + method to call into a more specific method on a derived visitor class + of the class. However, it should still + support unknown visitors by calling + . + + The visitor. + + is null. + + + The has been disposed. + + + + + Convert the TNEF content into a . + + + TNEF data often contains properties that map to + headers. TNEF data also often contains file attachments which will be + mapped to MIME parts. + + A message representing the TNEF data in MIME format. + + The property is null. + + + The has been disposed. + + + + + Extract the embedded attachments from the TNEF data. + + + Parses the TNEF data and extracts all of the embedded file attachments. + + The attachments. + + The property is null. + + + The has been disposed. + + + + + A TNEF property identifier. + + + A TNEF property identifier. + + + + + The MAPI property PR_AB_DEFAULT_DIR. + + + + + The MAPI property PR_AB_DEFAULT_PAB. + + + + + The MAPI property PR_AB_PROVIDER_ID. + + + + + The MAPI property PR_AB_PROVIDERS. + + + + + The MAPI property PR_AB_SEARCH_PATH. + + + + + The MAPI property PR_AB_SEARCH_PATH_UPDATE. + + + + + The MAPI property PR_ACCESS. + + + + + The MAPI property PR_ACCESS_LEVEL. + + + + + The MAPI property PR_ACCOUNT. + + + + + The MAPI property PR_ACKNOWLEDGEMENT_MODE. + + + + + The MAPI property PR_ADDRTYPE. + + + + + The MAPI property PR_ALTERNATE_RECIPIENT. + + + + + The MAPI property PR_ALTERNATE_RECIPIENT_ALLOWED. + + + + + The MAPI property PR_ANR. + + + + + The MAPI property PR_ASSISTANT. + + + + + The MAPI property PR_ASSISTANT_TELEPHONE_NUMBER. + + + + + The MAPI property PR_ASSOC_CONTENT_COUNT. + + + + + The MAPI property PR_ATTACH_ADDITIONAL_INFO. + + + + + The MAPI property PR_ATTACH_CONTENT_BASE. + + + + + The MAPI property PR_ATTACH_CONTENT_ID. + + + + + The MAPI property PR_ATTACH_CONTENT_LOCATION. + + + + + The MAPI property PR_ATTACH_DATA_BIN or PR_ATTACH_DATA_OBJ. + + + + + The MAPI property PR_ATTACH_DISPOSITION. + + + + + The MAPI property PR_ATTACH_ENCODING. + + + + + The MAPI property PR_ATTACH_EXTENSION. + + + + + The MAPI property PR_ATTACH_FILENAME. + + + + + The MAPI property PR_ATTACH_FLAGS. + + + + + The MAPI property PR_ATTACH_LONG_FILENAME. + + + + + The MAPI property PR_ATTACH_LONG_PATHNAME. + + + + + The MAPI property PR_ATTACHMENT_CONTACTPHOTO. + + + + + The MAPI property PR_ATTACHMENT_FLAGS. + + + + + The MAPI property PR_ATTACHMENT_HIDDEN. + + + + + The MAPI property PR_ATTACHMENT_LINKID. + + + + + The MAPI property PR_ATTACHMENT_X400_PARAMETERS. + + + + + The MAPI property PR_ATTACH_METHOD. + + + + + The MAPI property PR_ATTACH_MIME_SEQUENCE. + + + + + The MAPI property PR_ATTACH_MIME_TAG. + + + + + The MAPI property PR_ATTACH_NETSCAPE_MAC_INFO. + + + + + The MAPI property PR_ATTACH_NUM. + + + + + The MAPI property PR_ATTACH_PATHNAME. + + + + + The MAPI property PR_ATTACH_RENDERING. + + + + + The MAPI property PR_ATTACH_SIZE. + + + + + The MAPI property PR_ATTACH_TAG. + + + + + The MAPI property PR_ATTACH_TRANSPORT_NAME. + + + + + The MAPI property PR_AUTHORIZING_USERS. + + + + + The MAPI property PR_AUTO_FORWARDED. + + + + + The MAPI property PR_AUTO_FORWARDING_COMMENT. + + + + + The MAPI property PR_AUTO_RESPONSE_SUPPRESS. + + + + + The MAPI property PR_BEEPER_TELEPHONE_NUMBER. + + + + + The MAPI property PR_BIRTHDAY. + + + + + The MAPI property PR_BODY. + + + + + The MAPI property PR_BODY_CONTENT_ID. + + + + + The MAPI property PR_BODY_CONTENT_LOCATION. + + + + + The MAPI property PR_BODY_CRC. + + + + + The MAPI property PR_BODY_HTML. + + + + + The MAPI property PR_BUSINESS2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_BUSINESS_ADDRESS_CITY. + + + + + The MAPI property PR_BUSINESS_ADDRESS_COUNTRY. + + + + + The MAPI property PR_BUSINESS_ADDRESS_POSTAL_CODE. + + + + + The MAPI property PR_BUSINESS_ADDRESS_POST_OFFICE_BOX. + + + + + The MAPI property PR_BUSINESS_ADDRESS_STATE_OR_PROVINCE. + + + + + The MAPI property PR_BUSINESS_ADDRESS_STREET. + + + + + The MAPI property PR_BUSINESS_FAX_NUMBER. + + + + + The MAPI property PR_BUSINESS_HOME_PAGE. + + + + + The MAPI property PR_CALLBACK_TELEPHONE_NUMBER. + + + + + The MAPI property PR_CAR_TELEPHONE_NUMBER. + + + + + The MAPI property PR_CELLULAR_TELEPHONE_NUMBER. + + + + + The MAPI property PR_CHILDRENS_NAMES. + + + + + The MAPI property PR_CLIENT_SUBMIT_TIME. + + + + + The MAPI property PR_COMMENT. + + + + + The MAPI property PR_COMMON_VIEWS_ENTRYID. + + + + + The MAPI property PR_COMPANY_MAIN_PHONE_NUMBER. + + + + + The MAPI property PR_COMPANY_NAME. + + + + + The MAPI property PR_COMPUTER_NETWORK_NAME. + + + + + The MAPI property PR_CONTACT_ADDRTYPES. + + + + + The MAPI property PR_CONTACT_DEFAULT_ADDRESS_INDEX. + + + + + The MAPI property PR_CONTACT_EMAIL_ADDRESSES. + + + + + The MAPI property PR_CONTACT_ENTRYIDS. + + + + + The MAPI property PR_CONTACT_VERSION. + + + + + The MAPI property PR_CONTAINER_CLASS. + + + + + The MAPI property PR_CONTAINER_CONTENTS. + + + + + The MAPI property PR_CONTAINER_FLAGS. + + + + + The MAPI property PR_CONTAINER_HIERARCHY. + + + + + The MAPI property PR_CONTAINER_MODIFY_VERSION. + + + + + The MAPI property PR_CONTENT_CONFIDENTIALITY_ALGORITHM_ID. + + + + + The MAPI property PR_CONTENT_CORRELATOR. + + + + + The MAPI property PR_CONTENT_COUNT. + + + + + The MAPI property PR_CONTENT_IDENTIFIER. + + + + + The MAPI property PR_CONTENT_INTEGRITY_CHECK. + + + + + The MAPI property PR_CONTENT_LENGTH. + + + + + The MAPI property PR_CONTENT_RETURN_REQUESTED. + + + + + The MAPI property PR_CONTENTS_SORT_ORDER. + + + + + The MAPI property PR_CONTENT_UNREAD. + + + + + The MAPI property PR_CONTROL_FLAGS. + + + + + The MAPI property PR_CONTROL_ID. + + + + + The MAPI property PR_CONTROL_STRUCTURE. + + + + + The MAPI property PR_CONTROL_TYPE. + + + + + The MAPI property PR_CONVERSATION_INDEX. + + + + + The MAPI property PR_CONVERSATION_KEY. + + + + + The MAPI property PR_CONVERSATION_TOPIC. + + + + + The MAPI property PR_CONVERSATION_EITS. + + + + + The MAPI property PR_CONVERSION_PROHIBITED. + + + + + The MAPI property PR_CONVERSION_WITH_LOSS_PROHIBITED. + + + + + The MAPI property PR_CONVERTED_EITS. + + + + + The MAPI property PR_CORRELATE. + + + + + The MAPI property PR_CORRELATE_MTSID. + + + + + The MAPI property PR_COUNTRY. + + + + + The MAPI property PR_CREATE_TEMPLATES. + + + + + The MAPI property PR_CREATION_TIME. + + + + + The MAPI property PR_CREATION_VERSION. + + + + + The MAPI property PR_CREATOR_SMTP_ADDRESS. + + + + + The MAPI property PR_CURRENT_VERSION. + + + + + The MAPI property PR_CUSTOMER_ID. + + + + + The MAPI property PR_DEFAULT_PROFILE. + + + + + The MAPI property PR_DEFAULT_STORE. + + + + + The MAPI property PR_DEFAULT_VIEW_ENTRYID. + + + + + The MAPI property PR_DEF_CREATE_DL. + + + + + The MAPI property PR_DEF_CREATE_MAILUSER. + + + + + The MAPI property PR_DEFERRED_DELIVERY_TIME. + + + + + The MAPI property PR_DELEGATION. + + + + + The MAPI property PR_DELETE_AFTER_SUBMIT. + + + + + The MAPI property PR_DELIVER_TIME. + + + + + The MAPI property PR_DELIVERY_POINT. + + + + + The MAPI property PR_DELTAX. + + + + + The MAPI property PR_DELTAY. + + + + + The MAPI property PR_DEPARTMENT_NAME. + + + + + The MAPI property PR_DEPTH. + + + + + The MAPI property PR_DETAILS_TABLE. + + + + + The MAPI property PR_DISCARD_REASON. + + + + + The MAPI property PR_DISCLOSE_RECIPIENTS. + + + + + The MAPI property PR_DISCLOSURE_OF_RECIPIENTS. + + + + + The MAPI property PR_DISCRETE_VALUES. + + + + + The MAPI property PR_DISC_VAL. + + + + + The MAPI property PR_DISPLAY_BCC. + + + + + The MAPI property PR_DISPLAY_CC. + + + + + The MAPI property PR_DISPLAY_NAME. + + + + + The MAPI property PR_DISPLAY_NAME_PREFIX. + + + + + The MAPI property PR_DISPLAY_TO. + + + + + The MAPI property PR_DISPLAY_TYPE. + + + + + The MAPI property PR_DL_EXPANSION_HISTORY. + + + + + The MAPI property PR_DL_EXPANSION_PROHIBITED. + + + + + The MAPI property PR_EMAIL_ADDRESS. + + + + + The MAPI property PR_END_DATE. + + + + + The MAPI property PR_ENTRYID. + + + + + The MAPI property PR_EXCEPTION_STARTTIME. + + + + + The MAPI property PR_EXCEPTION_ENDTIME. + + + + + The MAPI property PR_EXPAND_BEGIN_TIME. + + + + + The MAPI property PR_EXPANDED_BEGIN_TIME. + + + + + The MAPI property PR_EXPANDED_END_TIME. + + + + + The MAPI property PR_EXPAND_END_TIME. + + + + + The MAPI property PR_EXPIRY_TIME. + + + + + The MAPI property PR_EXPLICIT_CONVERSION. + + + + + The MAPI property PR_FILTERING_HOOKS. + + + + + The MAPI property PR_FINDER_ENTRYID. + + + + + The MAPI property PR_FOLDER_ASSOCIATED_CONTENTS. + + + + + The MAPI property PR_FOLDER_TYPE. + + + + + The MAPI property PR_FORM_CATEGORY. + + + + + The MAPI property PR_FORM_CATEGORY_SUB. + + + + + The MAPI property PR_FORM_CLSID. + + + + + The MAPI property PR_FORM_CONTACT_NAME. + + + + + The MAPI property PR_FORM_DESIGNER_GUID. + + + + + The MAPI property PR_FORM_DESIGNER_NAME. + + + + + The MAPI property PR_FORM_HIDDEN. + + + + + The MAPI property PR_FORM_HOST_MAP. + + + + + The MAPI property PR_FORM_MESSAGE_BEHAVIOR. + + + + + The MAPI property PR_FORM_VERSION. + + + + + The MAPI property PR_FTP_SITE. + + + + + The MAPI property PR_GENDER. + + + + + The MAPI property PR_GENERATION. + + + + + The MAPI property PR_GIVEN_NAME. + + + + + The MAPI property PR_GOVERNMENT_ID_NUMBER. + + + + + The MAPI property PR_HASTTACH. + + + + + The MAPI property PR_HEADER_FOLDER_ENTRYID. + + + + + The MAPI property PR_HOBBIES. + + + + + The MAPI property PR_HOME2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_HOME_ADDRESS_CITY. + + + + + The MAPI property PR_HOME_ADDRESS_COUNTRY. + + + + + The MAPI property PR_HOME_ADDRESS_POSTAL_CODE. + + + + + The MAPI property PR_HOME_ADDRESS_POST_OFFICE_BOX. + + + + + The MAPI property PR_HOME_ADDRESS_STATE_OR_PROVINCE. + + + + + The MAPI property PR_HOME_ADDRESS_STREET. + + + + + The MAPI property PR_HOME_FAX_NUMBER. + + + + + The MAPI property PR_HOME_TELEPHONE_NUMBER. + + + + + The MAPI property PR_ICON. + + + + + The MAPI property PR_IDENTITY_DISPLAY. + + + + + The MAPI property PR_IDENTITY_ENTRYID. + + + + + The MAPI property PR_IDENTITY_SEARCH_KEY. + + + + + The MAPI property PR_IMPLICIT_CONVERSION_PROHIBITED. + + + + + The MAPI property PR_IMPORTANCE. + + + + + The MAPI property PR_INCOMPLETE_COPY. + + + + + The Internet mail override charset. + + + + + The Internet mail override format. + + + + + The MAPI property PR_INITIAL_DETAILS_PANE. + + + + + The MAPI property PR_INITIALS. + + + + + The MAPI property PR_IN_REPLY_TO_ID. + + + + + The MAPI property PR_INSTANCE_KEY. + + + + + The MAPI property PR_INTERNET_APPROVED. + + + + + The MAPI property PR_INTERNET_ARTICLE_NUMBER. + + + + + The MAPI property PR_INTERNET_CONTROL. + + + + + The MAPI property PR_INTERNET_CPID. + + + + + The MAPI property PR_INTERNET_DISTRIBUTION. + + + + + The MAPI property PR_INTERNET_FOLLOWUP_TO. + + + + + The MAPI property PR_INTERNET_LINES. + + + + + The MAPI property PR_INTERNET_MESSAGE_ID. + + + + + The MAPI property PR_INTERNET_NEWSGROUPS. + + + + + The MAPI property PR_INTERNET_NNTP_PATH. + + + + + The MAPI property PR_INTERNET_ORGANIZATION. + + + + + The MAPI property PR_INTERNET_PRECEDENCE. + + + + + The MAPI property PR_INTERNET_REFERENCES. + + + + + The MAPI property PR_IPM_ID. + + + + + The MAPI property PR_IPM_OUTBOX_ENTRYID. + + + + + The MAPI property PR_IPM_OUTBOX_SEARCH_KEY. + + + + + The MAPI property PR_IPM_RETURN_REQUESTED. + + + + + The MAPI property PR_IPM_SENTMAIL_ENTRYID. + + + + + The MAPI property PR_IPM_SENTMAIL_SEARCH_KEY. + + + + + The MAPI property PR_IPM_SUBTREE_ENTRYID. + + + + + The MAPI property PR_IPM_SUBTREE_SEARCH_KEY. + + + + + The MAPI property PR_IPM_WASTEBASKET_ENTRYID. + + + + + The MAPI property PR_IPM_WASTEBASKET_SEARCH_KEY. + + + + + The MAPI property PR_ISDN_NUMBER. + + + + + The MAPI property PR_KEYWORD. + + + + + The MAPI property PR_LANGUAGE. + + + + + The MAPI property PR_LANGUAGES. + + + + + The MAPI property PR_LAST_MODIFICATION_TIME. + + + + + The MAPI property PR_LAST_MODIFIER_NAME. + + + + + THe MAPI property PR_LAST_MODIFIER_SMTP_ADDRESS. + + + + + The MAPI property PR_LATEST_DELIVERY_TIME. + + + + + The MAPI property PR_LIST_HELP. + + + + + The MAPI property PR_LIST_SUBSCRIBE. + + + + + The MAPI property PR_LIST_UNSUBSCRIBE. + + + + + The MAPI property PR_LOCALITY. + + + + + The MAPI property PR_LOCALLY_DELIVERED. + + + + + The MAPI property PR_LOCATION. + + + + + The MAPI property PR_LOCK_BRANCH_ID. + + + + + The MAPI property PR_LOCK_DEPTH. + + + + + The MAPI property PR_LOCK_ENLISTMENT_CONTEXT. + + + + + The MAPI property PR_LOCK_EXPIRY_TIME. + + + + + The MAPI property PR_LOCK_PERSISTENT. + + + + + The MAPI property PR_LOCK_RESOURCE_DID. + + + + + The MAPI property PR_LOCK_RESOURCE_FID. + + + + + The MAPI property PR_LOCK_RESOURCE_MID. + + + + + The MAPI property PR_LOCK_SCOPE. + + + + + The MAPI property PR_LOCK_TIMEOUT. + + + + + The MAPI property PR_LOCK_TYPE. + + + + + The MAPI property PR_MAIL_PERMISSION. + + + + + The MAPI property PR_MANAGER_NAME. + + + + + The MAPI property PR_MAPPING_SIGNATURE. + + + + + The MAPI property PR_MDB_PROVIDER. + + + + + The MAPI property PR_MESSAGE_ATTACHMENTS. + + + + + The MAPI property PR_MESSAGE_CC_ME. + + + + + The MAPI property PR_MESSAGE_CLASS. + + + + + The MAPI property PR_MESSAGE_CODEPAGE. + + + + + The MAPI property PR_MESSAGE_DELIVERY_ID. + + + + + The MAPI property PR_MESSAGE_DELIVERY_TIME. + + + + + The MAPI property PR_MESSAGE_DOWNLOAD_TIME. + + + + + The MAPI property PR_MESSAGE_FLAGS. + + + + + The MAPI property PR_MESSAGE_RECIPIENTS. + + + + + The MAPI property PR_MESSAGE_RECIP_ME. + + + + + The MAPI property PR_MESSAGE_SECURITY_LABEL. + + + + + The MAPI property PR_MESSAGE_SIZE. + + + + + The MAPI property PR_MESSAGE_SUBMISSION_ID. + + + + + The MAPI property PR_MESSAGE_TOKEN. + + + + + The MAPI property PR_MESSAGE_TO_ME. + + + + + The MAPI property PR_MHS_COMMON_NAME. + + + + + The MAPI property PR_MIDDLE_NAME. + + + + + The MAPI property PR_MINI_ICON. + + + + + The MAPI property PR_MOBILE_TELEPHONE_NUMBER. + + + + + The MAPI property PR_MODIFY_VERSION. + + + + + The MAPI property PR_MSG_STATUS. + + + + + The MAPI property PR_NDR_DIAG_CODE. + + + + + The MAPI property PR_NDR_REASON_CODE. + + + + + The MAPI property PR_NDR_STATUS_CODE. + + + + + The MAPI property PR_NEWSGROUP_NAME. + + + + + The MAPI property PR_NICKNAME. + + + + + The MAPI property PR_NNTP_XREF. + + + + + The MAPI property PR_NON_RECEIPT_NOTIFICATION_REQUESTED. + + + + + The MAPI property PR_NON_RECEIPT_REASON. + + + + + The MAPI property PR_NORMALIZED_SUBJECT. + + + + + The MAPI property PR_NT_SECURITY_DESCRIPTOR. + + + + + The MAPI property PR_NULL. + + + + + The MAPI property PR_OBJECT_TYPE. + + + + + The MAPI property PR_OBSOLETE_IPMS. + + + + + The MAPI property PR_OFFICE2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_OFFICE_LOCATION. + + + + + The MAPI property PR_OFFICE_TELEPHONE_NUMBER. + + + + + The MAPI property PR_OOF_REPLY_TIME. + + + + + The MAPI property PR_ORGANIZATIONAL_ID_NUMBER. + + + + + The MAPI property PR_ORIG_ENTRYID. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_ADDRTYPE. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_ENTRYID. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_NAME. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_SEARCH_KEY. + + + + + The MAPI property PR_ORIGINAL_DELIVERY_TIME. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_BCC. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_CC. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_NAME. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_TO. + + + + + The MAPI property PR_ORIGINAL_EITS. + + + + + The MAPI property PR_ORIGINAL_ENTRYID. + + + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_ADRTYPE. + + + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_ENTRYID. + + + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIPIENT_NAME. + + + + + The MAPI property PR_ORIGINAL_SEARCH_KEY. + + + + + The MAPI property PR_ORIGINAL_SENDER_ADDRTYPE. + + + + + The MAPI property PR_ORIGINAL_SENDER_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINAL_SENDER_ENTRYID. + + + + + The MAPI property PR_ORIGINAL_SENDER_NAME. + + + + + The MAPI property PR_ORIGINAL_SENDER_SEARCH_KEY. + + + + + The MAPI property PR_ORIGINAL_SENSITIVITY. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_ENTRYID. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_NAME. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_SEARCH_KEY. + + + + + The MAPI property PR_ORIGINAL_SUBJECT. + + + + + The MAPI property PR_ORIGINAL_SUBMIT_TIME. + + + + + The MAPI property PR_ORIGINATING_MTA_CERTIFICATE. + + + + + The MAPI property PR_ORIGINATOR_AND_DL_EXPANSION_HISTORY. + + + + + The MAPI property PR_ORIGINATOR_CERTIFICATE. + + + + + The MAPI property PR_ORIGINATOR_DELIVERY_REPORT_REQUESTED. + + + + + The MAPI property PR_ORIGINATOR_NON_DELIVERY_REPORT_REQUESTED. + + + + + The MAPI property PR_ORIGINATOR_REQUESTED_ALTERNATE_RECIPIENT. + + + + + The MAPI property PR_ORIGINATOR_RETURN_ADDRESS. + + + + + The MAPI property PR_ORIGIN_CHECK. + + + + + The MAPI property PR_ORIG_MESSAGE_CLASS. + + + + + The MAPI property PR_OTHER_ADDRESS_CITY. + + + + + The MAPI property PR_OTHER_ADDRESS_COUNTRY. + + + + + The MAPI property PR_OTHER_ADDRESS_POSTAL_CODE. + + + + + The MAPI property PR_OTHER_ADDRESS_POST_OFFICE_BOX. + + + + + The MAPI property PR_OTHER_ADDRESS_STATE_OR_PROVINCE. + + + + + The MAPI property PR_OTHER_ADDRESS_STREET. + + + + + The MAPI property PR_OTHER_TELEPHONE_NUMBER. + + + + + The MAPI property PR_OWNER_APPT_ID. + + + + + The MAPI property PR_OWN_STORE_ENTRYID. + + + + + The MAPI property PR_PAGER_TELEPHONE_NUMBER. + + + + + The MAPI property PR_PARENT_DISPLAY. + + + + + The MAPI property PR_PARENT_ENTRYID. + + + + + The MAPI property PR_PARENT_KEY. + + + + + The MAPI property PR_PERSONAL_HOME_PAGE. + + + + + The MAPI property PR_PHYSICAL_DELIVERY_BUREAU_FAX_DELIVERY. + + + + + The MAPI property PR_PHYSICAL_DELIVERY_MODE. + + + + + The MAPI property PR_PHYSICAL_DELIVERY_REPORT_REQUEST. + + + + + The MAPI property PR_PHYSICAL_FORWARDING_ADDRESS. + + + + + The MAPI property PR_PHYSICAL_FORWARDING_ADDRESS_REQUESTED. + + + + + The MAPI property PR_PHYSICAL_FORWARDING_PROHIBITED. + + + + + The MAPI property PR_PHYSICAL_RENDITION_ATTRIBUTES. + + + + + The MAPI property PR_POSTAL_ADDRESS. + + + + + The MAPI property PR_POSTAL_CODE. + + + + + The MAPI property PR_POST_FOLDER_ENTRIES. + + + + + The MAPI property PR_POST_FOLDER_NAMES. + + + + + The MAPI property PR_POST_OFFICE_BOX. + + + + + The MAPI property PR_POST_REPLY_DENIED. + + + + + The MAPI property PR_POST_REPLY_FOLDER_ENTRIES. + + + + + The MAPI property PR_POST_REPLY_FOLDER_NAMES. + + + + + The MAPI property PR_PREFERRED_BY_NAME. + + + + + The MAPI property PR_PREPROCESS. + + + + + The MAPI property PR_PRIMARY_CAPABILITY. + + + + + The MAPI property PR_PRIMARY_FAX_NUMBER. + + + + + The MAPI property PR_PRIMARY_TELEPHONE_NUMBER. + + + + + The MAPI property PR_PRIORITY. + + + + + The MAPI property PR_PROFESSION. + + + + + The MAPI property PR_PROFILE_NAME. + + + + + The MAPI property PR_PROOF_OF_DELIVERY. + + + + + The MAPI property PR_PROOF_OF_DELIVERY_REQUESTED. + + + + + The MAPI property PR_PROOF_OF_SUBMISSION. + + + + + The MAPI property PR_PROOF_OF_SUBMISSION_REQUESTED. + + + + + The MAPI property PR_PROP_ID_SECURE_MAX. + + + + + The MAPI property PR_PROP_ID_SECURE_MIN. + + + + + The MAPI property PR_PROVIDER_DISPLAY. + + + + + The MAPI property PR_PROVIDER_DLL_NAME. + + + + + The MAPI property PR_PROVIDER_ORDINAL. + + + + + The MAPI property PR_PROVIDER_SUBMIT_TIME. + + + + + The MAPI property PR_PROVIDER_UID. + + + + + The MAPI property PR_PUID. + + + + + The MAPI property PR_RADIO_TELEPHONE_NUMBER. + + + + + The MAPI property PR_RCVD_REPRESENTING_ADDRTYPE. + + + + + The MAPI property PR_RCVD_REPRESENTING_EMAIL_ADDRESS. + + + + + The MAPI property PR_RCVD_REPRESENTING_ENTRYID. + + + + + The MAPI property PR_RCVD_REPRESENTING_NAME. + + + + + The MAPI property PR_RCVD_REPRESENTING_SEARCH_KEY. + + + + + The MAPI property PR_READ_RECEIPT_ENTRYID. + + + + + The MAPI property PR_READ_RECEIPT_REQUESTED. + + + + + The MAPI property PR_READ_RECEIPT_SEARCH_KEY. + + + + + The MAPI property PR_RECEIPT_TIME. + + + + + The MAPI property PR_RECEIVED_BY_ADDRTYPE. + + + + + The MAPI property PR_RECEIVED_BY_EMAIL_ADDRESS. + + + + + The MAPI property PR_RECEIVED_BY_ENTRYID. + + + + + The MAPI property PR_RECEIVED_BY_NAME. + + + + + The MAPI property PR_RECEIVED_BY_SEARCH_KEY. + + + + + The MAPI property PR_RECEIVE_FOLDER_SETTINGS. + + + + + The MAPI property PR_RECIPIENT_CERTIFICATE. + + + + + The MAPI property PR_RECIPIENT_DISPLAY_NAME. + + + + + The MAPI property PR_RECIPIENT_NUMBER_FOR_ADVICE. + + + + + The MAPI property PR_RECIPIENT_REASSIGNMENT_PROHIBITED. + + + + + The MAPI property PR_RECIPIENT_STATUS. + + + + + The MAPI property PR_RECIPIENT_TYPE. + + + + + The MAPI property PR_RECORD_KEY. + + + + + The MAPI property PR_REDIRECTION_HISTORY. + + + + + The MAPI property PR_REFERRED_BY_NAME. + + + + + The MAPI property PR_REGISTERED_MAIL_TYPE. + + + + + The MAPI property PR_RELATED_IPMS. + + + + + The MAPI property PR_REMOTE_PROGRESS. + + + + + The MAPI property PR_REMOTE_PROGRESS_TEXT. + + + + + The MAPI property PR_REMOTE_VALIDATE_OK. + + + + + The MAPI property PR_RENDERING_POSITION. + + + + + The MAPI property PR_REPLY_RECIPIENT_ENTRIES. + + + + + The MAPI property PR_REPLY_RECIPIENT_NAMES. + + + + + The MAPI property PR_REPLY_RECIPIENT_SMTP_PROXIES. + + + + + The MAPI property PR_REPLY_REQUESTED. + + + + + The MAPI property PR_REPLY_TIME. + + + + + The MAPI property PR_REPORT_ENTRYID. + + + + + The MAPI property PR_REPORTING_DLL_NAME. + + + + + The MAPI property PR_REPORTING_MTA_CERTIFICATE. + + + + + The MAPI property PR_REPORT_NAME. + + + + + The MAPI property PR_REPORT_SEARCH_KEY. + + + + + The MAPI property PR_REPORT_TAG. + + + + + The MAPI property PR_REPORT_TEXT. + + + + + The MAPI property PR_REPORT_TIME. + + + + + The MAPI property PR_REQUESTED_DELIVERY_METHOD. + + + + + The MAPI property PR_RESOURCE_FLAGS. + + + + + The MAPI property PR_RESOURCE_METHODS. + + + + + The MAPI property PR_RESOURCE_PATH. + + + + + The MAPI property PR_RESOURCE_TYPE. + + + + + The MAPI property PR_RESPONSE_REQUESTED. + + + + + The MAPI property PR_RESPONSIBILITY. + + + + + The MAPI property PR_RETURNED_IPM. + + + + + The MAPI property PR_ROWID. + + + + + The MAPI property PR_ROW_TYPE. + + + + + The MAPI property PR_RTF_COMPRESSED. + + + + + The MAPI property PR_RTF_IN_SYNC. + + + + + The MAPI property PR_SYNC_BODY_COUNT. + + + + + The MAPI property PR_RTF_SYNC_BODY_CRC. + + + + + The MAPI property PR_RTF_SYNC_BODY_TAG. + + + + + The MAPI property PR_RTF_SYNC_PREFIX_COUNT. + + + + + The MAPI property PR_RTF_SYNC_TRAILING_COUNT. + + + + + The MAPI property PR_SEARCH. + + + + + The MAPI property PR_SEARCH_KEY. + + + + + The MAPI property PR_SECURITY. + + + + + The MAPI property PR_SELECTABLE. + + + + + The MAPI property PR_SENDER_ADDRTYPE. + + + + + The MAPI property PR_SENDER_EMAIL_ADDRESS. + + + + + The MAPI property PR_SENDER_ENTRYID. + + + + + The MAPI property PR_SENDER_NAME. + + + + + The MAPI property PR_SENDER_SEARCH_KEY. + + + + + The MAPI property PR_SENDER_SIMPLE_DISP_NAME. + + + + + The MAPI property PR_SENDER_SMTP_ADDRESS. + + + + + The MAPI property PR_SEND_INTERNET_ENCODING. + + + + + The MAPI property PR_SEND_RECALL_REPORT. + + + + + The MAPI property PR_SEND_RICH_INFO. + + + + + The MAPI property PR_SENSITIVITY. + + + + + The MAPI property PR_SENTMAIL_ENTRYID. + + + + + The MAPI property PR_SENT_REPRESENTING_ADDRTYPE. + + + + + The MAPI property PR_SENT_REPRESENTING_EMAIL_ADDRESS. + + + + + The MAPI property PR_SENT_REPRESENTING_ENTRYID. + + + + + The MAPI property PR_SENT_REPRESENTING_NAME. + + + + + The MAPI property PR_SENT_REPRESENTING_SEARCH_KEY. + + + + + The MAPI property PR_SENT_REPRESENTING_SIMPLE_DISP_NAME. + + + + + The MAPI property PR_SERVICE_DELETE_FILES. + + + + + The MAPI property PR_SERVICE_DLL_NAME. + + + + + The MAPI property PR_SERVICE_ENTRY_NAME. + + + + + The MAPI property PR_SERVICE_EXTRA_UIDS. + + + + + The MAPI property PR_SERVICE_NAME. + + + + + The MAPI property PR_SERVICES. + + + + + The MAPI property PR_SERVICE_SUPPORT_FILES. + + + + + The MAPI property PR_SERVICE_UID. + + + + + The MAPI property PR_SEVEN_BIT_DISPLAY_NAME. + + + + + The MAPI property PR_SMTP_ADDRESS. + + + + + The MAPI property PR_SPOOLER_STATUS. + + + + + The MAPI property PR_SPOUSE_NAME. + + + + + The MAPI property PR_START_DATE. + + + + + The MAPI property PR_STATE_OR_PROVINCE. + + + + + The MAPI property PR_STATUS. + + + + + The MAPI property PR_STATUS_CODE. + + + + + The MAPI property PR_STATUS_STRING. + + + + + The MAPI property PR_STORE_ENTRYID. + + + + + The MAPI property PR_STORE_PROVIDERS. + + + + + The MAPI property PR_STORE_RECORD_KEY. + + + + + The MAPI property PR_STORE_STATE. + + + + + The MAPI property PR_STORE_SUPPORT_MASK. + + + + + The MAPI property PR_STREET_ADDRESS. + + + + + The MAPI property PR_SUBFOLDERS. + + + + + The MAPI property PR_SUBJECT. + + + + + The MAPI property PR_SUBJECT_IPM. + + + + + The MAPI property PR_SUBJECT_PREFIX. + + + + + The MAPI property PR_SUBMIT_FLAGS. + + + + + The MAPI property PR_SUPERSEDES. + + + + + The MAPI property PR_SUPPLEMENTARY_INFO. + + + + + The MAPI property PR_SURNAME. + + + + + The MAPI property PR_TELEX_NUMBER. + + + + + The MAPI property PR_TEMPLATEID. + + + + + The MAPI property PR_TITLE. + + + + + The MAPI property PR_TNEF_CORRELATION_KEY. + + + + + The MAPI property PR_TRANSMITABLE_DISPLAY_NAME. + + + + + The MAPI property PR_TRANSPORT_KEY. + + + + + The MAPI property PR_TRANSPORT_MESSAGE_HEADERS. + + + + + The MAPI property PR_TRANSPORT_PROVIDERS. + + + + + The MAPI property PR_TRANSPORT_STATUS. + + + + + The MAPI property PR_TTYTDD_PHONE_NUMBER. + + + + + The MAPI property PR_TYPE_OF_MTS_USER. + + + + + The MAPI property PR_USER_CERTIFICATE. + + + + + The MAPI property PR_USER_X509_CERTIFICATE. + + + + + The MAPI property PR_VALID_FOLDER_MASK. + + + + + The MAPI property PR_VIEWS_ENTRYID. + + + + + The MAPI property PR_WEDDING_ANNIVERSARY. + + + + + The MAPI property PR_X400_CONTENT_TYPE. + + + + + The MAPI property PR_X400_DEFERRED_DELIVERY_CANCEL. + + + + + The MAPI property PR_XPOS. + + + + + The MAPI property PR_YPOS. + + + + + A TNEF property reader. + + + A TNEF property reader. + + + + + Get a value indicating whether the current property is an embedded TNEF message. + + + Gets a value indicating whether the current property is an embedded TNEF message. + + true if the current property is an embedded TNEF message; otherwise, false. + + + + Get a value indicating whether or not the current property has multiple values. + + + Gets a value indicating whether or not the current property has multiple values. + + true if the current property has multiple values; otherwise, false. + + + + Get a value indicating whether or not the current property is a named property. + + + Gets a value indicating whether or not the current property is a named property. + + true if the current property is a named property; otherwise, false. + + + + Get a value indicating whether the current property contains object values. + + + Gets a value indicating whether the current property contains object values. + + true if the current property contains object values; otherwise, false. + + + + Get the number of properties available. + + + Gets the number of properties available. + + The property count. + + + + Get the property name identifier. + + + Gets the property name identifier. + + The property name identifier. + + + + Get the property tag. + + + Gets the property tag. + + The property tag. + + + + Get the length of the raw value. + + + Gets the length of the raw value. + + The length of the raw value. + + + + Get the raw value stream offset. + + + Gets the raw value stream offset. + + The raw value stream offset. + + + + Get the number of table rows available. + + + Gets the number of table rows available. + + The row count. + + + + Get the number of values available. + + + Gets the number of values available. + + The value count. + + + + Get the type of the value. + + + Gets the type of the value. + + The type of the value. + + + + Get the embedded TNEF message reader. + + + Gets the embedded TNEF message reader. + + The embedded TNEF message reader. + + The property does not contain any more values. + -or- + The property value is not an embedded message. + + + + + Get the raw value of the attribute or property as a stream. + + + Gets the raw value of the attribute or property as a stream. + + The raw value stream. + + The property does not contain any more values. + + + + + Advance to the next MAPI property. + + + Advances to the next MAPI property. + + true if there is another property available to be read; otherwise false. + + The TNEF data is corrupt or invalid. + + + + + Advance to the next table row of properties. + + + Advances to the next table row of properties. + + true if there is another row available to be read; otherwise false. + + The TNEF data is corrupt or invalid. + + + + + Advance to the next value in the TNEF stream. + + + Advances to the next value in the TNEF stream. + + true if there is another value available to be read; otherwise false. + + The TNEF data is corrupt or invalid. + + + + + Read the raw attribute or property value as a sequence of bytes. + + + Reads the raw attribute or property value as a sequence of bytes. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many + bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + An I/O error occurred. + + + + + Read the raw attribute or property value as a sequence of unicode characters. + + + Reads the raw attribute or property value as a sequence of unicode characters. + + The total number of characters read into the buffer. This can be less than the number of characters + requested if that many bytes are not currently available, or zero (0) if the end of the stream has been + reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of characters to read. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain characters starting + at the specified . + + + An I/O error occurred. + + + + + Read the value. + + + Reads an attribute or property value as its native type. + + The value. + + There are no more values to read or the value could not be read. + + + The TNEF stream is truncated and the value could not be read. + + + + + Read the value as a boolean. + + + Reads any integer-based attribute or property value as a boolean. + + The value as a boolean. + + There are no more values to read or the value could not be read as a boolean. + + + The TNEF stream is truncated and the value could not be read. + + + + + Read the value as a byte array. + + + Reads any string, binary blob, Class ID, or Object attribute or property value as a byte array. + + The value as a byte array. + + There are no more values to read or the value could not be read as a byte array. + + + The TNEF stream is truncated and the value could not be read. + + + + + Read the value as a date and time. + + + Reads any date and time attribute or property value as a . + + The value as a date and time. + + There are no more values to read or the value could not be read as a date and time. + + + The TNEF stream is truncated and the value could not be read. + + + + + Read the value as a double. + + + Reads any numeric attribute or property value as a double. + + The value as a double. + + There are no more values to read or the value could not be read as a double. + + + The TNEF stream is truncated and the value could not be read. + + + + + Read the value as a float. + + + Reads any numeric attribute or property value as a float. + + The value as a float. + + There are no more values to read or the value could not be read as a float. + + + The TNEF stream is truncated and the value could not be read. + + + + + Read the value as a GUID. + + + Reads any Class ID value as a GUID. + + The value as a GUID. + + There are no more values to read or the value could not be read as a GUID. + + + The TNEF stream is truncated and the value could not be read. + + + + + Read the value as a 16-bit integer. + + + Reads any integer-based attribute or property value as a 16-bit integer. + + The value as a 16-bit integer. + + There are no more values to read or the value could not be read as a 16-bit integer. + + + The TNEF stream is truncated and the value could not be read. + + + + + Read the value as a 32-bit integer. + + + Reads any integer-based attribute or property value as a 32-bit integer. + + The value as a 32-bit integer. + + There are no more values to read or the value could not be read as a 32-bit integer. + + + The TNEF stream is truncated and the value could not be read. + + + + + Read the value as a 64-bit integer. + + + Reads any integer-based attribute or property value as a 64-bit integer. + + The value as a 64-bit integer. + + There are no more values to read or the value could not be read as a 64-bit integer. + + + The TNEF stream is truncated and the value could not be read. + + + + + Read the value as a string. + + + Reads any string or binary blob values as a string. + + The value as a string. + + There are no more values to read or the value could not be read as a string. + + + The TNEF stream is truncated and the value could not be read. + + + + + Read the value as a Uri. + + + Reads any string or binary blob values as a Uri. + + The value as a Uri. + + There are no more values to read or the value could not be read as a string. + + + The TNEF stream is truncated and the value could not be read. + + + + + Serves as a hash function for a object. + + + Serves as a hash function for a object. + + A hash code for this instance that is suitable for use in hashing algorithms + and data structures such as a hash table. + + + + Determine whether the specified is equal to the current . + + + 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. + + + + A TNEF property tag. + + + A TNEF property tag. + + + + + The MAPI property PR_AB_DEFAULT_DIR. + + + The MAPI property PR_AB_DEFAULT_DIR. + + + + + The MAPI property PR_AB_DEFAULT_PAB. + + + The MAPI property PR_AB_DEFAULT_PAD. + + + + + The MAPI property PR_AB_PROVIDER_ID. + + + The MAPI property PR_AB_PROVIDER_ID. + + + + + The MAPI property PR_AB_PROVIDERS. + + + The MAPI property PR_AB_PROVIDERS. + + + + + The MAPI property PR_AB_SEARCH_PATH. + + + The MAPI property PR_AB_SEARCH_PATH. + + + + + The MAPI property PR_AB_SEARCH_PATH_UPDATE. + + + The MAPI property PR_AB_SEARCH_PATH_UPDATE. + + + + + The MAPI property PR_ACCESS. + + + The MAPI property PR_ACCESS. + + + + + The MAPI property PR_ACCESS_LEVEL. + + + The MAPI property PR_ACCESS_LEVEL. + + + + + The MAPI property PR_ACCOUNT. + + + The MAPI property PR_ACCOUNT. + + + + + The MAPI property PR_ACCOUNT. + + + The MAPI property PR_ACCOUNT. + + + + + The MAPI property PR_ACKNOWLEDGEMENT_MODE. + + + The MAPI property PR_ACKNOWLEDGEMENT_MODE. + + + + + The MAPI property PR_ADDRTYPE. + + + The MAPI property PR_ADDRTYPE. + + + + + The MAPI property PR_ADDRTYPE. + + + The MAPI property PR_ADDRTYPE. + + + + + The MAPI property PR_ALTERNATE_RECIPIENT. + + + The MAPI property PR_ALTERNATE_RECIPIENT. + + + + + The MAPI property PR_ALTERNATE_RECIPIENT_ALLOWED. + + + The MAPI property PR_ALTERNATE_RECIPIENT_ALLOWED. + + + + + The MAPI property PR_ANR. + + + The MAPI property PR_ANR. + + + + + The MAPI property PR_ANR. + + + The MAPI property PR_ANR. + + + + + The MAPI property PR_ASSISTANT. + + + The MAPI property PR_ASSISTANT. + + + + + The MAPI property PR_ASSISTANT. + + + The MAPI property PR_ASSISTANT. + + + + + The MAPI property PR_ASSISTANT_TELEPHONE_NUMBER. + + + The MAPI property PR_ASSISTANT_TELEPHONE_NUMBER. + + + + + The MAPI property PR_ASSISTANT_TELEPHONE_NUMBER. + + + The MAPI property PR_ASSISTANT_TELEPHONE_NUMBER. + + + + + The MAPI property PR_ASSOC_CONTENT_COUNT. + + + The MAPI property PR_ASSOC_CONTENT_COUNT. + + + + + The MAPI property PR_ATTACH_ADDITIONAL_INFO. + + + The MAPI property PR_ATTACH_ADDITIONAL_INFO. + + + + + The MAPI property PR_ATTACH_CONTENT_BASE. + + + The MAPI property PR_ATTACH_CONTENT_BASE. + + + + + The MAPI property PR_ATTACH_CONTENT_BASE. + + + The MAPI property PR_ATTACH_CONTENT_BASE. + + + + + The MAPI property PR_ATTACH_CONTENT_ID. + + + The MAPI property PR_ATTACH_CONTENT_ID. + + + + + The MAPI property PR_ATTACH_CONTENT_ID. + + + The MAPI property PR_ATTACH_CONTENT_ID. + + + + + The MAPI property PR_ATTACH_CONTENT_LOCATION. + + + The MAPI property PR_ATTACH_CONTENT_LOCATION. + + + + + The MAPI property PR_ATTACH_CONTENT_LOCATION. + + + The MAPI property PR_ATTACH_CONTENT_LOCATION. + + + + + The MAPI property PR_ATTACH_DATA. + + + The MAPI property PR_ATTACH_DATA. + + + + + The MAPI property PR_ATTACH_DATA. + + + The MAPI property PR_ATTACH_DATA. + + + + + The MAPI property PR_ATTACH_DISPOSITION. + + + The MAPI property PR_ATTACH_DISPOSITION. + + + + + The MAPI property PR_ATTACH_DISPOSITION. + + + The MAPI property PR_ATTACH_DISPOSITION. + + + + + The MAPI property PR_ATTACH_ENCODING. + + + The MAPI property PR_ATTACH_ENCODING. + + + + + The MAPI property PR_ATTACH_EXTENSION. + + + The MAPI property PR_ATTACH_EXTENSION. + + + + + The MAPI property PR_ATTACH_EXTENSION. + + + The MAPI property PR_ATTACH_EXTENSION. + + + + + The MAPI property PR_ATTACH_FILENAME. + + + The MAPI property PR_ATTACH_FILENAME. + + + + + The MAPI property PR_ATTACH_FILENAME. + + + The MAPI property PR_ATTACH_FILENAME. + + + + + The MAPI property PR_ATTACH_FLAGS. + + + The MAPI property PR_ATTACH_FLAGS. + + + + + The MAPI property PR_ATTACH_LONG_FILENAME. + + + The MAPI property PR_ATTACH_LONG_FILENAME. + + + + + The MAPI property PR_ATTACH_LONG_FILENAME. + + + The MAPI property PR_ATTACH_LONG_FILENAME. + + + + + The MAPI property PR_ATTACH_LONG_PATHNAME. + + + The MAPI property PR_ATTACH_LONG_PATHNAME. + + + + + The MAPI property PR_ATTACH_LONG_PATHNAME. + + + The MAPI property PR_ATTACH_LONG_PATHNAME. + + + + + The MAPI property PR_ATTACHMENT_CONTACTPHOTO. + + + The MAPI property PR_ATTACHMENT_CONTACTPHOTO. + + + + + The MAPI property PR_ATTACHMENT_FLAGS. + + + The MAPI property PR_ATTACHMENT_FLAGS. + + + + + The MAPI property PR_ATTACHMENT_HIDDEN. + + + The MAPI property PR_ATTACHMENT_HIDDEN. + + + + + The MAPI property PR_ATTACHMENT_LINKID. + + + The MAPI property PR_ATTACHMENT_LINKID. + + + + + The MAPI property PR_ATTACHMENT_X400_PARAMETERS. + + + The MAPI property PR_ATTACHMENT_X400_PARAMETERS. + + + + + The MAPI property PR_ATTACH_METHOD. + + + The MAPI property PR_ATTACH_METHOD. + + + + + The MAPI property PR_ATTACH_MIME_SEQUENCE. + + + The MAPI property PR_ATTACH_MIME_SEQUENCE. + + + + + The MAPI property PR_ATTACH_MIME_TAG. + + + The MAPI property PR_ATTACH_MIME_TAG. + + + + + The MAPI property PR_ATTACH_MIME_TAG. + + + The MAPI property PR_ATTACH_MIME_TAG. + + + + + The MAPI property PR_ATTACH_NETSCAPE_MAC_INFO. + + + The MAPI property PR_ATTACH_NETSCAPE_MAC_INFO. + + + + + The MAPI property PR_ATTACH_NUM. + + + The MAPI property PR_ATTACH_NUM. + + + + + The MAPI property PR_ATTACH_PATHNAME. + + + The MAPI property PR_ATTACH_PATHNAME. + + + + + The MAPI property PR_ATTACH_PATHNAME. + + + The MAPI property PR_ATTACH_PATHNAME. + + + + + The MAPI property PR_ATTACH_RENDERING. + + + The MAPI property PR_ATTACH_RENDERING. + + + + + The MAPI property PR_ATTACH_SIZE. + + + The MAPI property PR_ATTACH_SIZE. + + + + + The MAPI property PR_ATTACH_TAG. + + + The MAPI property PR_ATTACH_TAG. + + + + + The MAPI property PR_ATTACH_TRANSPORT_NAME. + + + The MAPI property PR_ATTACH_TRANSPORT_NAME. + + + + + The MAPI property PR_ATTACH_TRANSPORT_NAME. + + + The MAPI property PR_ATTACH_TRANSPORT_NAME. + + + + + The MAPI property PR_AUTHORIZING_USERS. + + + The MAPI property PR_AUTHORIZING_USERS. + + + + + The MAPI property PR_AUTOFORWARDED. + + + The MAPI property PR_AUTOFORWARDED. + + + + + The MAPI property PR_AUTOFORWARDING_COMMENT. + + + The MAPI property PR_AUTOFORWARDING_COMMENT. + + + + + The MAPI property PR_AUTOFORWARDING_COMMENT. + + + The MAPI property PR_AUTOFORWARDING_COMMENT. + + + + + The MAPI property PR_AUTORESPONSE_SUPPRESS. + + + The MAPI property PR_AUTORESPONSE_SUPPRESS. + + + + + The MAPI property PR_BEEPER_TELEPHONE_NUMBER. + + + The MAPI property PR_BEEPER_TELEPHONE_NUMBER. + + + + + The MAPI property PR_BEEPER_TELEPHONE_NUMBER. + + + The MAPI property PR_BEEPER_TELEPHONE_NUMBER. + + + + + The MAPI property PR_BIRTHDAY. + + + The MAPI property PR_BIRTHDAY. + + + + + The MAPI property PR_BODY. + + + The MAPI property PR_BODY. + + + + + The MAPI property PR_BODY. + + + The MAPI property PR_BODY. + + + + + The MAPI property PR_BODY_CONTENT_ID. + + + The MAPI property PR_BODY_CONTENT_ID. + + + + + The MAPI property PR_BODY_CONTENT_ID. + + + The MAPI property PR_BODY_CONTENT_ID. + + + + + The MAPI property PR_BODY_CONTENT_LOCATION. + + + The MAPI property PR_BODY_CONTENT_LOCATION. + + + + + The MAPI property PR_BODY_CONTENT_LOCATION. + + + The MAPI property PR_BODY_CONTENT_LOCATION. + + + + + The MAPI property PR_BODY_CRC. + + + The MAPI property PR_BODY_CRC. + + + + + The MAPI property PR_BODY_HTML. + + + The MAPI property PR_BODY_HTML. + + + + + The MAPI property PR_BODY_HTML. + + + The MAPI property PR_BODY_HTML. + + + + + The MAPI property PR_BODY_HTML. + + + The MAPI property PR_BODY_HTML. + + + + + The MAPI property PR_BUSINESS2_TELEPHONE_NUMBER. + + + The MAPI property PR_BUSINESS2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_BUSINESS2_TELEPHONE_NUMBER. + + + The MAPI property PR_BUSINESS2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_BUSINESS2_TELEPHONE_NUMBER. + + + The MAPI property PR_BUSINESS2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_BUSINESS2_TELEPHONE_NUMBER. + + + The MAPI property PR_BUSINESS2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_BUSINESS_ADDRESS_CITY. + + + The MAPI property PR_BUSINESS_ADDRESS_CITY. + + + + + The MAPI property PR_BUSINESS_ADDRESS_CITY. + + + The MAPI property PR_BUSINESS_ADDRESS_CITY. + + + + + The MAPI property PR_BUSINESS_ADDRESS_COUNTRY. + + + The MAPI property PR_BUSINESS_ADDRESS_COUNTRY. + + + + + The MAPI property PR_BUSINESS_ADDRESS_COUNTRY. + + + The MAPI property PR_BUSINESS_ADDRESS_COUNTRY. + + + + + The MAPI property PR_BUSINESS_ADDRESS_POSTAL_CODE. + + + The MAPI property PR_BUSINESS_ADDRESS_POSTAL_CODE. + + + + + The MAPI property PR_BUSINESS_ADDRESS_POSTAL_CODE. + + + The MAPI property PR_BUSINESS_ADDRESS_POSTAL_CODE. + + + + + The MAPI property PR_BUSINESS_ADDRESS_POSTAL_STREET. + + + The MAPI property PR_BUSINESS_ADDRESS_POSTAL_STREET. + + + + + The MAPI property PR_BUSINESS_ADDRESS_POSTAL_STREET. + + + The MAPI property PR_BUSINESS_ADDRESS_POSTAL_STREET. + + + + + The MAPI property PR_BUSINESS_FAX_NUMBER. + + + The MAPI property PR_BUSINESS_FAX_NUMBER. + + + + + The MAPI property PR_BUSINESS_FAX_NUMBER. + + + The MAPI property PR_BUSINESS_FAX_NUMBER. + + + + + The MAPI property PR_BUSINESS_HOME_PAGE. + + + The MAPI property PR_BUSINESS_HOME_PAGE. + + + + + The MAPI property PR_BUSINESS_HOME_PAGE. + + + The MAPI property PR_BUSINESS_HOME_PAGE. + + + + + The MAPI property PR_CALLBACK_TELEPHONE_NUMBER. + + + The MAPI property PR_CALLBACK_TELEPHONE_NUMBER. + + + + + The MAPI property PR_CALLBACK_TELEPHONE_NUMBER. + + + The MAPI property PR_CALLBACK_TELEPHONE_NUMBER. + + + + + The MAPI property PR_CAR_TELEPHONE_NUMBER. + + + The MAPI property PR_CAR_TELEPHONE_NUMBER. + + + + + The MAPI property PR_CAR_TELEPHONE_NUMBER. + + + The MAPI property PR_CAR_TELEPHONE_NUMBER. + + + + + The MAPI property PR_CHILDRENS_NAMES. + + + The MAPI property PR_CHILDRENS_NAMES. + + + + + The MAPI property PR_CHILDRENS_NAMES. + + + The MAPI property PR_CHILDRENS_NAMES. + + + + + The MAPI property PR_CLIENT_SUBMIT_TIME. + + + The MAPI property PR_CLIENT_SUBMIT_TIME. + + + + + The MAPI property PR_COMMENT. + + + The MAPI property PR_COMMENT. + + + + + The MAPI property PR_COMMENT. + + + The MAPI property PR_COMMENT. + + + + + The MAPI property PR_COMMON_VIEWS_ENTRYID. + + + The MAPI property PR_COMMON_VIEWS_ENTRYID. + + + + + The MAPI property PR_COMPANY_MAIN_PHONE_NUMBER. + + + The MAPI property PR_COMPANY_MAIN_PHONE_NUMBER. + + + + + The MAPI property PR_COMPANY_MAIN_PHONE_NUMBER. + + + The MAPI property PR_COMPANY_MAIN_PHONE_NUMBER. + + + + + The MAPI property PR_COMPANY_NAME. + + + The MAPI property PR_COMPANY_NAME. + + + + + The MAPI property PR_COMPANY_NAME. + + + The MAPI property PR_COMPANY_NAME. + + + + + The MAPI property PR_COMPUTER_NETWORK_NAME. + + + The MAPI property PR_COMPUTER_NETWORK_NAME. + + + + + The MAPI property PR_COMPUTER_NETWORK_NAME. + + + The MAPI property PR_COMPUTER_NETWORK_NAME. + + + + + The MAPI property PR_CONTACT_ADDRTYPES. + + + The MAPI property PR_CONTACT_ADDRTYPES. + + + + + The MAPI property PR_CONTACT_ADDRTYPES. + + + The MAPI property PR_CONTACT_ADDRTYPES. + + + + + The MAPI property PR_CONTACT_DEFAULT_ADDRESS_INDEX. + + + The MAPI property PR_CONTACT_DEFAULT_ADDRESS_INDEX. + + + + + The MAPI property PR_CONTACT_EMAIL_ADDRESSES. + + + The MAPI property PR_CONTACT_EMAIL_ADDRESSES. + + + + + The MAPI property PR_CONTACT_EMAIL_ADDRESSES. + + + The MAPI property PR_CONTACT_EMAIL_ADDRESSES. + + + + + The MAPI property PR_CONTACT_ENTRYIDS. + + + The MAPI property PR_CONTACT_ENTRYIDS. + + + + + The MAPI property PR_CONTACT_VERSION. + + + The MAPI property PR_CONTACT_VERSION. + + + + + The MAPI property PR_CONTAINER_CLASS. + + + The MAPI property PR_CONTAINER_CLASS. + + + + + The MAPI property PR_CONTAINER_CLASS. + + + The MAPI property PR_CONTAINER_CLASS. + + + + + The MAPI property PR_CONTAINER_CONTENTS. + + + The MAPI property PR_CONTAINER_CONTENTS. + + + + + The MAPI property PR_CONTAINER_FLAGS. + + + The MAPI property PR_CONTAINER_FLAGS. + + + + + The MAPI property PR_CONTAINER_HIERARCHY. + + + The MAPI property PR_CONTAINER_HIERARCHY. + + + + + The MAPI property PR_CONTAINER_MODIFY_VERSION. + + + The MAPI property PR_CONTAINER_MODIFY_VERSION. + + + + + The MAPI property PR_CONTENT_CONFIDENTIALITY_ALGORITHM_ID. + + + The MAPI property PR_CONTENT_CONFIDENTIALITY_ALGORITHM_ID. + + + + + The MAPI property PR_CONTENT_CORRELATOR. + + + The MAPI property PR_CONTENT_CORRELATOR. + + + + + The MAPI property PR_CONTENT_COUNT. + + + The MAPI property PR_CONTENT_COUNT. + + + + + The MAPI property PR_CONTENT_IDENTIFIER. + + + The MAPI property PR_CONTENT_IDENTIFIER. + + + + + The MAPI property PR_CONTENT_IDENTIFIER. + + + The MAPI property PR_CONTENT_IDENTIFIER. + + + + + The MAPI property PR_CONTENT_INTEGRITY_CHECK. + + + The MAPI property PR_CONTENT_INTEGRITY_CHECK. + + + + + The MAPI property PR_CONTENT_LENGTH. + + + The MAPI property PR_CONTENT_LENGTH. + + + + + The MAPI property PR_CONTENT_RETURN_REQUESTED. + + + The MAPI property PR_CONTENT_RETURN_REQUESTED. + + + + + The MAPI property PR_CONTENTS_SORT_ORDER. + + + The MAPI property PR_CONTENTS_SORT_ORDER. + + + + + The MAPI property PR_CONTENT_UNREAD. + + + The MAPI property PR_CONTENT_UNREAD. + + + + + The MAPI property PR_CONTROL_FLAGS. + + + The MAPI property PR_CONTROL_FLAGS. + + + + + The MAPI property PR_CONTROL_ID. + + + The MAPI property PR_CONTROL_ID. + + + + + The MAPI property PR_CONTROL_STRUCTURE. + + + The MAPI property PR_CONTROL_STRUCTURE. + + + + + The MAPI property PR_CONTROL_TYPE. + + + The MAPI property PR_CONTROL_TYPE. + + + + + The MAPI property PR_CONVERSATION_INDEX. + + + The MAPI property PR_CONVERSATION_INDEX. + + + + + The MAPI property PR_CONVERSATION_KEY. + + + The MAPI property PR_CONVERSATION_KEY. + + + + + The MAPI property PR_CONVERSATION_TOPIC. + + + The MAPI property PR_CONVERSATION_TOPIC. + + + + + The MAPI property PR_CONVERSATION_TOPIC. + + + The MAPI property PR_CONVERSATION_TOPIC. + + + + + The MAPI property PR_CONVERSION_EITS. + + + The MAPI property PR_CONVERSION_EITS. + + + + + The MAPI property PR_CONVERSION_PROHIBITED. + + + The MAPI property PR_CONVERSION_PROHIBITED. + + + + + The MAPI property PR_CONVERSION_WITH_LOSS_PROHIBITED. + + + The MAPI property PR_CONVERSION_WITH_LOSS_PROHIBITED. + + + + + The MAPI property PR_CONVERTED_EITS. + + + The MAPI property PR_CONVERTED_EITS. + + + + + The MAPI property PR_CORRELATE. + + + The MAPI property PR_CORRELATE. + + + + + The MAPI property PR_CORRELATE_MTSID. + + + The MAPI property PR_CORRELATE_MTSID. + + + + + The MAPI property PR_COUNTRY. + + + The MAPI property PR_COUNTRY. + + + + + The MAPI property PR_COUNTRY. + + + The MAPI property PR_COUNTRY. + + + + + The MAPI property PR_CREATE_TEMPLATES. + + + The MAPI property PR_CREATE_TEMPLATES. + + + + + The MAPI property PR_CREATION_TIME. + + + The MAPI property PR_CREATION_TIME. + + + + + The MAPI property PR_CREATION_VERSION. + + + The MAPI property PR_CREATION_VERSION. + + + + + The MAPI property PR_CURRENT_VERSION. + + + The MAPI property PR_CURRENT_VERSION. + + + + + The MAPI property PR_CUSTOMER_ID. + + + The MAPI property PR_CUSTOMER_ID. + + + + + The MAPI property PR_CUSTOMER_ID. + + + The MAPI property PR_CUSTOMER_ID. + + + + + The MAPI property PR_DEFAULT_PROFILE. + + + The MAPI property PR_DEFAULT_PROFILE. + + + + + The MAPI property PR_DEFAULT_STORE. + + + The MAPI property PR_DEFAULT_STORE. + + + + + The MAPI property PR_DEFAULT_VIEW_ENTRYID. + + + The MAPI property PR_DEFAULT_VIEW_ENTRYID. + + + + + The MAPI property PR_DEF_CREATE_DL. + + + The MAPI property PR_DEF_CREATE_DL. + + + + + The MAPI property PR_DEF_CREATE_MAILUSER. + + + The MAPI property PR_DEF_CREATE_MAILUSER. + + + + + The MAPI property PR_DEFERRED_DELIVERY_TIME. + + + The MAPI property PR_DEFERRED_DELIVERY_TIME. + + + + + The MAPI property PR_DELEGATION. + + + The MAPI property PR_DELEGATION. + + + + + The MAPI property PR_DELETE_AFTER_SUBMIT. + + + The MAPI property PR_DELETE_AFTER_SUBMIT. + + + + + The MAPI property PR_DELIVER_TIME. + + + The MAPI property PR_DELIVER_TIME. + + + + + The MAPI property PR_DELIVERY_POINT. + + + The MAPI property PR_DELIVERY_POINT. + + + + + The MAPI property PR_DELTAX. + + + The MAPI property PR_DELTAX. + + + + + The MAPI property PR_DELTAY. + + + The MAPI property PR_DELTAY. + + + + + The MAPI property PR_DEPARTMENT_NAME. + + + The MAPI property PR_DEPARTMENT_NAME. + + + + + The MAPI property PR_DEPARTMENT_NAME. + + + The MAPI property PR_DEPARTMENT_NAME. + + + + + The MAPI property PR_DEPTH. + + + The MAPI property PR_DEPTH. + + + + + The MAPI property PR_DETAILS_TABLE. + + + The MAPI property PR_DETAILS_TABLE. + + + + + The MAPI property PR_DISCARD_REASON. + + + The MAPI property PR_DISCARD_REASON. + + + + + The MAPI property PR_DISCLOSE_RECIPIENTS. + + + The MAPI property PR_DISCLOSE_RECIPIENTS. + + + + + The MAPI property PR_DISCLOSURE_OF_RECIPIENTS. + + + The MAPI property PR_DISCLOSURE_OF_RECIPIENTS. + + + + + The MAPI property PR_DISCRETE_VALUES. + + + The MAPI property PR_DISCRETE_VALUES. + + + + + The MAPI property PR_DISC_VAL. + + + The MAPI property PR_DISC_VAL. + + + + + The MAPI property PR_DISPLAY_BCC. + + + The MAPI property PR_DISPLAY_BCC. + + + + + The MAPI property PR_DISPLAY_BCC. + + + The MAPI property PR_DISPLAY_BCC. + + + + + The MAPI property PR_DISPLAY_CC. + + + The MAPI property PR_DISPLAY_CC. + + + + + The MAPI property PR_DISPLAY_CC. + + + The MAPI property PR_DISPLAY_CC. + + + + + The MAPI property PR_DISPLAY_NAME. + + + The MAPI property PR_DISPLAY_NAME. + + + + + The MAPI property PR_DISPLAY_NAME. + + + The MAPI property PR_DISPLAY_NAME. + + + + + The MAPI property PR_DISPLAY_NAME_PREFIX. + + + The MAPI property PR_DISPLAY_NAME_PREFIX. + + + + + The MAPI property PR_DISPLAY_NAME_PREFIX. + + + The MAPI property PR_DISPLAY_NAME_PREFIX. + + + + + The MAPI property PR_DISPLAY_TO. + + + The MAPI property PR_DISPLAY_TO. + + + + + The MAPI property PR_DISPLAY_TO. + + + The MAPI property PR_DISPLAY_TO. + + + + + The MAPI property PR_DISPLAY_TYPE. + + + The MAPI property PR_DISPLAY_TYPE. + + + + + The MAPI property PR_DL_EXPANSION_HISTORY. + + + The MAPI property PR_DL_EXPANSION_HISTORY. + + + + + The MAPI property PR_DL_EXPANSION_PROHIBITED. + + + The MAPI property PR_DL_EXPANSION_PROHIBITED. + + + + + The MAPI property PR_EMAIL_ADDRESS. + + + The MAPI property PR_EMAIL_ADDRESS. + + + + + The MAPI property PR_EMAIL_ADDRESS. + + + The MAPI property PR_EMAIL_ADDRESS. + + + + + The MAPI property PR_END_DATE. + + + The MAPI property PR_END_DATE. + + + + + The MAPI property PR_ENTRYID. + + + The MAPI property PR_ENTRYID. + + + + + The MAPI property PR_EXPAND_BEGIN_TIME. + + + The MAPI property PR_EXPAND_BEGIN_TIME. + + + + + The MAPI property PR_EXPANDED_BEGIN_TIME. + + + The MAPI property PR_EXPANDED_BEGIN_TIME. + + + + + The MAPI property PR_EXPANDED_END_TIME. + + + The MAPI property PR_EXPANDED_END_TIME. + + + + + The MAPI property PR_EXPAND_END_TIME. + + + The MAPI property PR_EXPAND_END_TIME. + + + + + The MAPI property PR_EXPIRY_TIME. + + + The MAPI property PR_EXPIRY_TIME. + + + + + The MAPI property PR_EXPLICIT_CONVERSION. + + + The MAPI property PR_EXPLICIT_CONVERSION. + + + + + The MAPI property PR_FILTERING_HOOKS. + + + The MAPI property PR_FILTERING_HOOKS. + + + + + The MAPI property PR_FINDER_ENTRYID. + + + The MAPI property PR_FINDER_ENTRYID. + + + + + The MAPI property PR_FOLDER_ASSOCIATED_CONTENTS. + + + The MAPI property PR_FOLDER_ASSOCIATED_CONTENTS. + + + + + The MAPI property PR_FOLDER_TYPE. + + + The MAPI property PR_FOLDER_TYPE. + + + + + The MAPI property PR_FORM_CATEGORY. + + + The MAPI property PR_FORM_CATEGORY. + + + + + The MAPI property PR_FORM_CATEGORY. + + + The MAPI property PR_FORM_CATEGORY. + + + + + The MAPI property PR_FORM_CATEGORY_SUB. + + + The MAPI property PR_FORM_CATEGORY_SUB. + + + + + The MAPI property PR_FORM_CATEGORY_SUB. + + + The MAPI property PR_FORM_CATEGORY_SUB. + + + + + The MAPI property PR_FORM_CLSID. + + + The MAPI property PR_FORM_CLSID. + + + + + The MAPI property PR_FORM_CONTACT_NAME. + + + The MAPI property PR_FORM_CONTACT_NAME. + + + + + The MAPI property PR_FORM_CONTACT_NAME. + + + The MAPI property PR_FORM_CONTACT_NAME. + + + + + The MAPI property PR_FORM_DESIGNER_GUID. + + + The MAPI property PR_FORM_DESIGNER_GUID. + + + + + The MAPI property PR_FORM_DESIGNER_NAME. + + + The MAPI property PR_FORM_DESIGNER_NAME. + + + + + The MAPI property PR_FORM_DESIGNER_NAME. + + + The MAPI property PR_FORM_DESIGNER_NAME. + + + + + The MAPI property PR_FORM_HIDDEN. + + + The MAPI property PR_FORM_HIDDEN. + + + + + The MAPI property PR_FORM_HOST_MAP. + + + The MAPI property PR_FORM_HOST_MAP. + + + + + The MAPI property PR_FORM_MESSAGE_BEHAVIOR. + + + The MAPI property PR_FORM_MESSAGE_BEHAVIOR. + + + + + The MAPI property PR_FORM_VERSION. + + + The MAPI property PR_FORM_VERSION. + + + + + The MAPI property PR_FORM_VERSION. + + + The MAPI property PR_FORM_VERSION. + + + + + The MAPI property PR_FTP_SITE. + + + The MAPI property PR_FTP_SITE. + + + + + The MAPI property PR_FTP_SITE. + + + The MAPI property PR_FTP_SITE. + + + + + The MAPI property PR_GENDER. + + + The MAPI property PR_GENDER. + + + + + The MAPI property PR_GENERATION. + + + The MAPI property PR_GENERATION. + + + + + The MAPI property PR_GENERATION. + + + The MAPI property PR_GENERATION. + + + + + The MAPI property PR_GIVEN_NAME. + + + The MAPI property PR_GIVEN_NAME. + + + + + The MAPI property PR_GIVEN_NAME. + + + The MAPI property PR_GIVEN_NAME. + + + + + The MAPI property PR_GOVERNMENT_ID_NUMBER. + + + The MAPI property PR_GOVERNMENT_ID_NUMBER. + + + + + The MAPI property PR_GOVERNMENT_ID_NUMBER. + + + The MAPI property PR_GOVERNMENT_ID_NUMBER. + + + + + The MAPI property PR_HASATTACH. + + + The MAPI property PR_HASATTACH. + + + + + The MAPI property PR_HEADER_FOLDER_ENTRYID. + + + The MAPI property PR_HEADER_FOLDER_ENTRYID. + + + + + The MAPI property PR_HOBBIES. + + + The MAPI property PR_HOBBIES. + + + + + The MAPI property PR_HOBBIES. + + + The MAPI property PR_HOBBIES. + + + + + The MAPI property PR_HOME2_TELEPHONE_NUMBER. + + + The MAPI property PR_HOME2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_HOME2_TELEPHONE_NUMBER. + + + The MAPI property PR_HOME2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_HOME2_TELEPHONE_NUMBER. + + + The MAPI property PR_HOME2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_HOME2_TELEPHONE_NUMBER. + + + The MAPI property PR_HOME2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_HOME_ADDRESS_CITY. + + + The MAPI property PR_HOME_ADDRESS_CITY. + + + + + The MAPI property PR_HOME_ADDRESS_CITY. + + + The MAPI property PR_HOME_ADDRESS_CITY. + + + + + The MAPI property PR_HOME_ADDRESS_COUNTRY. + + + The MAPI property PR_HOME_ADDRESS_COUNTRY. + + + + + The MAPI property PR_HOME_ADDRESS_COUNTRY. + + + The MAPI property PR_HOME_ADDRESS_COUNTRY. + + + + + The MAPI property PR_HOME_ADDRESS_POSTAL_CODE. + + + The MAPI property PR_HOME_ADDRESS_POSTAL_CODE. + + + + + The MAPI property PR_HOME_ADDRESS_POSTAL_CODE. + + + The MAPI property PR_HOME_ADDRESS_POSTAL_CODE. + + + + + The MAPI property PR_HOME_ADDRESS_POST_OFFICE_BOX. + + + The MAPI property PR_HOME_ADDRESS_POST_OFFICE_BOX. + + + + + The MAPI property PR_HOME_ADDRESS_POST_OFFICE_BOX. + + + The MAPI property PR_HOME_ADDRESS_POST_OFFICE_BOX. + + + + + The MAPI property PR_HOME_ADDRESS_STATE_OR_PROVINCE. + + + The MAPI property PR_HOME_ADDRESS_STATE_OR_PROVINCE. + + + + + The MAPI property PR_HOME_ADDRESS_STATE_OR_PROVINCE. + + + The MAPI property PR_HOME_ADDRESS_STATE_OR_PROVINCE. + + + + + The MAPI property PR_HOME_ADDRESS_STREET. + + + The MAPI property PR_HOME_ADDRESS_STREET. + + + + + The MAPI property PR_HOME_ADDRESS_STREET. + + + The MAPI property PR_HOME_ADDRESS_STREET. + + + + + The MAPI property PR_HOME_FAX_NUMBER. + + + The MAPI property PR_HOME_FAX_NUMBER. + + + + + The MAPI property PR_HOME_FAX_NUMBER. + + + The MAPI property PR_HOME_FAX_NUMBER. + + + + + The MAPI property PR_HOME_TELEPHONE_NUMBER. + + + The MAPI property PR_HOME_TELEPHONE_NUMBER. + + + + + The MAPI property PR_HOME_TELEPHONE_NUMBER. + + + The MAPI property PR_HOME_TELEPHONE_NUMBER. + + + + + The MAPI property PR_ICON. + + + The MAPI property PR_ICON. + + + + + The MAPI property PR_IDENTITY_DISPLAY. + + + The MAPI property PR_IDENTITY_DISPLAY. + + + + + The MAPI property PR_IDENTITY_DISPLAY. + + + The MAPI property PR_IDENTITY_DISPLAY. + + + + + The MAPI property PR_IDENTITY_ENTRYID. + + + The MAPI property PR_IDENTITY_ENTRYID. + + + + + The MAPI property PR_IDENTITY_SEARCH_KEY. + + + The MAPI property PR_IDENTITY_SEARCH_KEY. + + + + + The MAPI property PR_IMPLICIT_CONVERSION_PROHIBITED. + + + The MAPI property PR_IMPLICIT_CONVERSION_PROHIBITED. + + + + + The MAPI property PR_IMPORTANCE. + + + The MAPI property PR_IMPORTANCE. + + + + + The MAPI property PR_INCOMPLETE_COPY. + + + The MAPI property PR_INCOMPLETE_COPY. + + + + + The Internet mail override charset. + + + The Internet mail override charset. + + + + + The Internet mail override format. + + + The Internet mail override format. + + + + + The MAPI property PR_INITIAL_DETAILS_PANE. + + + The MAPI property PR_INITIAL_DETAILS_PANE. + + + + + The MAPI property PR_INITIALS. + + + The MAPI property PR_INITIALS. + + + + + The MAPI property PR_INITIALS. + + + The MAPI property PR_INITIALS. + + + + + The MAPI property PR_IN_REPLY_TO_ID. + + + The MAPI property PR_IN_REPLY_TO_ID. + + + + + The MAPI property PR_IN_REPLY_TO_ID. + + + The MAPI property PR_IN_REPLY_TO_ID. + + + + + The MAPI property PR_INSTANCE_KEY. + + + The MAPI property PR_INSTANCE_KEY. + + + + + The MAPI property PR_INTERNET_APPROVED. + + + The MAPI property PR_INTERNET_APPROVED. + + + + + The MAPI property PR_INTERNET_APPROVED. + + + The MAPI property PR_INTERNET_APPROVED. + + + + + The MAPI property PR_INTERNET_ARTICLE_NUMBER. + + + The MAPI property PR_INTERNET_ARTICLE_NUMBER. + + + + + The MAPI property PR_INTERNET_CONTROL. + + + The MAPI property PR_INTERNET_CONTROL. + + + + + The MAPI property PR_INTERNET_CONTROL. + + + The MAPI property PR_INTERNET_CONTROL. + + + + + The MAPI property PR_INTERNET_CPID. + + + The MAPI property PR_INTERNET_CPID. + + + + + The MAPI property PR_INTERNET_DISTRIBUTION. + + + The MAPI property PR_INTERNET_DISTRIBUTION. + + + + + The MAPI property PR_INTERNET_DISTRIBUTION. + + + The MAPI property PR_INTERNET_DISTRIBUTION. + + + + + The MAPI property PR_INTERNET_FOLLOWUP_TO. + + + The MAPI property PR_INTERNET_FOLLOWUP_TO. + + + + + The MAPI property PR_INTERNET_FOLLOWUP_TO. + + + The MAPI property PR_INTERNET_FOLLOWUP_TO. + + + + + The MAPI property PR_INTERNET_LINES. + + + The MAPI property PR_INTERNET_LINES. + + + + + The MAPI property PR_INTERNET_MESSAGE_ID. + + + The MAPI property PR_INTERNET_MESSAGE_ID. + + + + + The MAPI property PR_INTERNET_MESSAGE_ID. + + + The MAPI property PR_INTERNET_MESSAGE_ID. + + + + + The MAPI property PR_INTERNET_NEWSGROUPS. + + + The MAPI property PR_INTERNET_NEWSGROUPS. + + + + + The MAPI property PR_INTERNET_NEWSGROUPS. + + + The MAPI property PR_INTERNET_NEWSGROUPS. + + + + + The MAPI property PR_INTERNET_NNTP_PATH. + + + The MAPI property PR_INTERNET_NNTP_PATH. + + + + + The MAPI property PR_INTERNET_NNTP_PATH. + + + The MAPI property PR_INTERNET_NNTP_PATH. + + + + + The MAPI property PR_INTERNET_ORGANIZATION. + + + The MAPI property PR_INTERNET_ORGANIZATION. + + + + + The MAPI property PR_INTERNET_ORGANIZATION. + + + The MAPI property PR_INTERNET_ORGANIZATION. + + + + + The MAPI property PR_INTERNET_PRECEDENCE. + + + The MAPI property PR_INTERNET_PRECEDENCE. + + + + + The MAPI property PR_INTERNET_PRECEDENCE. + + + The MAPI property PR_INTERNET_PRECEDENCE. + + + + + The MAPI property PR_INTERNET_REFERENCES. + + + The MAPI property PR_INTERNET_REFERENCES. + + + + + The MAPI property PR_INTERNET_REFERENCES. + + + The MAPI property PR_INTERNET_REFERENCES. + + + + + The MAPI property PR_IPM_ID. + + + The MAPI property PR_IPM_ID. + + + + + The MAPI property PR_IPM_OUTBOX_ENTRYID. + + + The MAPI property PR_IPM_OUTBOX_ENTRYID. + + + + + The MAPI property PR_IPM_OUTBOX_SEARCH_KEY. + + + The MAPI property PR_IPM_OUTBOX_SEARCH_KEY. + + + + + The MAPI property PR_IPM_RETURN_REQUESTED. + + + The MAPI property PR_IPM_RETURN_REQUESTED. + + + + + The MAPI property PR_IPM_SENTMAIL_ENTRYID. + + + The MAPI property PR_IPM_SENTMAIL_ENTRYID. + + + + + The MAPI property PR_IPM_SENTMAIL_SEARCH_KEY. + + + The MAPI property PR_IPM_SENTMAIL_SEARCH_KEY. + + + + + The MAPI property PR_IPM_SUBTREE_ENTRYID. + + + The MAPI property PR_IPM_SUBTREE_ENTRYID. + + + + + The MAPI property PR_IPM_SUBTREE_SEARCH_KEY. + + + The MAPI property PR_IPM_SUBTREE_SEARCH_KEY. + + + + + The MAPI property PR_IPM_WASTEBASKET_ENTRYID. + + + The MAPI property PR_IPM_WASTEBASKET_ENTRYID. + + + + + The MAPI property PR_IPM_WASTEBASKET_SEARCH_KEY. + + + The MAPI property PR_IPM_WASTEBASKET_SEARCH_KEY. + + + + + The MAPI property PR_ISDN_NUMBER. + + + The MAPI property PR_ISDN_NUMBER. + + + + + The MAPI property PR_ISDN_NUMBER. + + + The MAPI property PR_ISDN_NUMBER. + + + + + The MAPI property PR_KEYWORD. + + + The MAPI property PR_KEYWORD. + + + + + The MAPI property PR_KEYWORD. + + + The MAPI property PR_KEYWORD. + + + + + The MAPI property PR_LANGUAGE. + + + The MAPI property PR_LANGUAGE. + + + + + The MAPI property PR_LANGUAGE. + + + The MAPI property PR_LANGUAGE. + + + + + The MAPI property PR_LANGUAGES. + + + The MAPI property PR_LANGUAGES. + + + + + The MAPI property PR_LANGUAGES. + + + The MAPI property PR_LANGUAGES. + + + + + The MAPI property PR_LAST_MODIFICATION_TIME. + + + The MAPI property PR_LAST_MODIFICATION_TIME. + + + + + The MAPI property PR_LAST_MODIFIER_NAME. + + + The MAPI property PR_LAST_MODIFIER_NAME. + + + + + The MAPI property PR_LAST_MODIFIER_NAME. + + + The MAPI property PR_LAST_MODIFIER_NAME. + + + + + The MAPI property PR_LATEST_DELIVERY_TIME. + + + The MAPI property PR_LATEST_DELIVERY_TIME. + + + + + The MAPI property PR_LIST_HELP. + + + The MAPI property PR_LIST_HELP. + + + + + The MAPI property PR_LIST_HELP. + + + The MAPI property PR_LIST_HELP. + + + + + The MAPI property PR_LIST_SUBSCRIBE. + + + The MAPI property PR_LIST_SUBSCRIBE. + + + + + The MAPI property PR_LIST_SUBSCRIBE. + + + The MAPI property PR_LIST_SUBSCRIBE. + + + + + The MAPI property PR_LIST_UNSUBSCRIBE. + + + The MAPI property PR_LIST_UNSUBSCRIBE. + + + + + The MAPI property PR_LIST_UNSUBSCRIBE. + + + The MAPI property PR_LIST_UNSUBSCRIBE. + + + + + The MAPI property PR_LOCALITY. + + + The MAPI property PR_LOCALITY. + + + + + The MAPI property PR_LOCALITY. + + + The MAPI property PR_LOCALITY. + + + + + The MAPI property PR_LOCATION. + + + The MAPI property PR_LOCATION. + + + + + The MAPI property PR_LOCATION. + + + The MAPI property PR_LOCATION. + + + + + The MAPI property PR_LOCK_BRANCH_ID. + + + The MAPI property PR_LOCK_BRANCH_ID. + + + + + The MAPI property PR_LOCK_DEPTH. + + + The MAPI property PR_LOCK_DEPTH. + + + + + The MAPI property PR_LOCK_ENLISTMENT_CONTEXT. + + + The MAPI property PR_LOCK_ENLISTMENT_CONTEXT. + + + + + The MAPI property PR_LOCK_EXPIRY_TIME. + + + The MAPI property PR_LOCK_EXPIRY_TIME. + + + + + The MAPI property PR_LOCK_PERSISTENT. + + + The MAPI property PR_LOCK_PERSISTENT. + + + + + The MAPI property PR_LOCK_RESOURCE_DID. + + + The MAPI property PR_LOCK_RESOURCE_DID. + + + + + The MAPI property PR_LOCK_RESOURCE_FID. + + + The MAPI property PR_LOCK_RESOURCE_FID. + + + + + The MAPI property PR_LOCK_RESOURCE_MID. + + + The MAPI property PR_LOCK_RESOURCE_MID. + + + + + The MAPI property PR_LOCK_SCOPE. + + + The MAPI property PR_LOCK_SCOPE. + + + + + The MAPI property PR_LOCK_TIMEOUT. + + + The MAPI property PR_LOCK_TIMEOUT. + + + + + The MAPI property PR_LOCK_TYPE. + + + The MAPI property PR_LOCK_TYPE. + + + + + The MAPI property PR_MAIL_PERMISSION. + + + The MAPI property PR_MAIL_PERMISSION. + + + + + The MAPI property PR_MANAGER_NAME. + + + The MAPI property PR_MANAGER_NAME. + + + + + The MAPI property PR_MANAGER_NAME. + + + The MAPI property PR_MANAGER_NAME. + + + + + The MAPI property PR_MAPPING_SIGNATURE. + + + The MAPI property PR_MAPPING_SIGNATURE. + + + + + The MAPI property PR_MDB_PROVIDER. + + + The MAPI property PR_MDB_PROVIDER. + + + + + The MAPI property PR_MESSAGE_ATTACHMENTS. + + + The MAPI property PR_MESSAGE_ATTACHMENTS. + + + + + The MAPI property PR_MESSAGE_CC_ME. + + + The MAPI property PR_MESSAGE_CC_ME. + + + + + The MAPI property PR_MESSAGE_CLASS. + + + The MAPI property PR_MESSAGE_CLASS. + + + + + The MAPI property PR_MESSAGE_CLASS. + + + The MAPI property PR_MESSAGE_CLASS. + + + + + The MAPI property PR_MESSAGE_CODEPAGE. + + + The MAPI property PR_MESSAGE_CODEPAGE. + + + + + The MAPI property PR_MESSAGE_DELIVERY_ID. + + + The MAPI property PR_MESSAGE_DELIVERY_ID. + + + + + The MAPI property PR_MESSAGE_DELIVERY_TIME. + + + The MAPI property PR_MESSAGE_DELIVERY_TIME. + + + + + The MAPI property PR_MESSAGE_DOWNLOAD_TIME. + + + The MAPI property PR_MESSAGE_DOWNLOAD_TIME. + + + + + The MAPI property PR_MESSAGE_FLAGS. + + + The MAPI property PR_MESSAGE_FLAGS. + + + + + The MAPI property PR_MESSAGE_RECIPIENTS. + + + The MAPI property PR_MESSAGE_RECIPIENTS. + + + + + The MAPI property PR_MESSAGE_RECIP_ME. + + + The MAPI property PR_MESSAGE_RECIP_ME. + + + + + The MAPI property PR_MESSAGE_SECURITY_LABEL. + + + The MAPI property PR_MESSAGE_SECURITY_LABEL. + + + + + The MAPI property PR_MESSAGE_SIZE. + + + The MAPI property PR_MESSAGE_SIZE. + + + + + The MAPI property PR_MESSAGE_SUBMISSION_ID. + + + The MAPI property PR_MESSAGE_SUBMISSION_ID. + + + + + The MAPI property PR_MESSAGE_TOKEN. + + + The MAPI property PR_MESSAGE_TOKEN. + + + + + The MAPI property PR_MESSAGE_TO_ME. + + + The MAPI property PR_MESSAGE_TO_ME. + + + + + The MAPI property PR_MHS_COMMON_NAME. + + + The MAPI property PR_MHS_COMMON_NAME. + + + + + The MAPI property PR_MHS_COMMON_NAME. + + + The MAPI property PR_MHS_COMMON_NAME. + + + + + The MAPI property PR_MIDDLE_NAME. + + + The MAPI property PR_MIDDLE_NAME. + + + + + The MAPI property PR_MIDDLE_NAME. + + + The MAPI property PR_MIDDLE_NAME. + + + + + The MAPI property PR_MINI_ICON. + + + The MAPI property PR_MINI_ICON. + + + + + The MAPI property PR_MOBILE_TELEPHONE_NUMBER. + + + The MAPI property PR_MOBILE_TELEPHONE_NUMBER. + + + + + The MAPI property PR_MOBILE_TELEPHONE_NUMBER. + + + The MAPI property PR_MOBILE_TELEPHONE_NUMBER. + + + + + The MAPI property PR_MODIFY_VERSION. + + + The MAPI property PR_MODIFY_VERSION. + + + + + The MAPI property PR_MSG_STATUS. + + + The MAPI property PR_MSG_STATUS. + + + + + The MAPI property PR_NDR_DIAG_CODE. + + + The MAPI property PR_NDR_DIAG_CODE. + + + + + The MAPI property PR_NDR_REASON_CODE. + + + The MAPI property PR_NDR_REASON_CODE. + + + + + The MAPI property PR_NDR_STATUS_CODE. + + + The MAPI property PR_NDR_STATUS_CODE. + + + + + The MAPI property PR_NEWSGROUP_NAME. + + + The MAPI property PR_NEWSGROUP_NAME. + + + + + The MAPI property PR_NEWSGROUP_NAME. + + + The MAPI property PR_NEWSGROUP_NAME. + + + + + The MAPI property PR_NICKNAME. + + + The MAPI property PR_NICKNAME. + + + + + The MAPI property PR_NICKNAME. + + + The MAPI property PR_NICKNAME. + + + + + The MAPI property PR_NNTP_XREF. + + + The MAPI property PR_NNTP_XREF. + + + + + The MAPI property PR_NNTP_XREF. + + + The MAPI property PR_NNTP_XREF. + + + + + The MAPI property PR_NON_RECEIPT_NOTIFICATION_REQUESTED. + + + The MAPI property PR_NON_RECEIPT_NOTIFICATION_REQUESTED. + + + + + The MAPI property PR_NON_RECEIPT_REASON. + + + The MAPI property PR_NON_RECEIPT_REASON. + + + + + The MAPI property PR_NORMALIZED_SUBJECT. + + + The MAPI property PR_NORMALIZED_SUBJECT. + + + + + The MAPI property PR_NORMALIZED_SUBJECT. + + + The MAPI property PR_NORMALIZED_SUBJECT. + + + + + The MAPI property PR_NT_SECURITY_DESCRIPTOR. + + + The MAPI property PR_NT_SECURITY_DESCRIPTOR. + + + + + The MAPI property PR_NULL. + + + The MAPI property PR_NULL. + + + + + The MAPI property PR_OBJECT_TYPE. + + + The MAPI property PR_OBJECT_TYPE. + + + + + The MAPI property PR_OBSOLETE_IPMS. + + + The MAPI property PR_OBSOLETE_IPMS. + + + + + The MAPI property PR_OFFICE2_TELEPHONE_NUMBER. + + + The MAPI property PR_OFFICE2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_OFFICE2_TELEPHONE_NUMBER. + + + The MAPI property PR_OFFICE2_TELEPHONE_NUMBER. + + + + + The MAPI property PR_OFFICE_LOCATION. + + + The MAPI property PR_OFFICE_LOCATION. + + + + + The MAPI property PR_OFFICE_LOCATION. + + + The MAPI property PR_OFFICE_LOCATION. + + + + + The MAPI property PR_OFFICE_TELEPHONE_NUMBER. + + + The MAPI property PR_OFFICE_TELEPHONE_NUMBER. + + + + + The MAPI property PR_OFFICE_TELEPHONE_NUMBER. + + + The MAPI property PR_OFFICE_TELEPHONE_NUMBER. + + + + + The MAPI property PR_OOF_REPLY_TYPE. + + + The MAPI property PR_OOF_REPLY_TYPE. + + + + + The MAPI property PR_ORGANIZATIONAL_ID_NUMBER. + + + The MAPI property PR_ORGANIZATIONAL_ID_NUMBER. + + + + + The MAPI property PR_ORGANIZATIONAL_ID_NUMBER. + + + The MAPI property PR_ORGANIZATIONAL_ID_NUMBER. + + + + + The MAPI property PR_ORIG_ENTRYID. + + + The MAPI property PR_ORIG_ENTRYID. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_ADDRTYPE. + + + The MAPI property PR_ORIGINAL_AUTHOR_ADDRTYPE. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_ADDRTYPE. + + + The MAPI property PR_ORIGINAL_AUTHOR_ADDRTYPE. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_EMAIL_ADDRESS. + + + The MAPI property PR_ORIGINAL_AUTHOR_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_EMAIL_ADDRESS. + + + The MAPI property PR_ORIGINAL_AUTHOR_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_ENTRYID. + + + The MAPI property PR_ORIGINAL_AUTHOR_ENTRYID. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_NAME. + + + The MAPI property PR_ORIGINAL_AUTHOR_NAME. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_NAME. + + + The MAPI property PR_ORIGINAL_AUTHOR_NAME. + + + + + The MAPI property PR_ORIGINAL_AUTHOR_SEARCH_KEY. + + + The MAPI property PR_ORIGINAL_AUTHOR_SEARCH_KEY. + + + + + The MAPI property PR_ORIGINAL_DELIVERY_TIME. + + + The MAPI property PR_ORIGINAL_DELIVERY_TIME. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_BCC. + + + The MAPI property PR_ORIGINAL_DISPLAY_BCC. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_BCC. + + + The MAPI property PR_ORIGINAL_DISPLAY_BCC. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_CC. + + + The MAPI property PR_ORIGINAL_DISPLAY_CC. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_CC. + + + The MAPI property PR_ORIGINAL_DISPLAY_CC. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_NAME. + + + The MAPI property PR_ORIGINAL_DISPLAY_NAME. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_NAME. + + + The MAPI property PR_ORIGINAL_DISPLAY_NAME. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_TO. + + + The MAPI property PR_ORIGINAL_DISPLAY_TO. + + + + + The MAPI property PR_ORIGINAL_DISPLAY_TO. + + + The MAPI property PR_ORIGINAL_DISPLAY_TO. + + + + + The MAPI property PR_ORIGINAL_EITS. + + + The MAPI property PR_ORIGINAL_EITS. + + + + + The MAPI property PR_ORIGINAL_ENTRYID. + + + The MAPI property PR_ORIGINAL_ENTRYID. + + + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_ADDRTYPE. + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_ADDRTYPE. + + + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_ADDRTYPE. + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_ADDRTYPE. + + + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_EMAIL_ADDRESS. + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_EMAIL_ADDRESS. + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_ENTRYID. + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIP_ENTRYID. + + + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIPIENT_NAME. + + + The MAPI property PR_ORIGINALLY_INTENDED_RECIPIENT_NAME. + + + + + The MAPI property PR_ORIGINAL_SEARCH_KEY. + + + The MAPI property PR_ORIGINAL_SEARCH_KEY. + + + + + The MAPI property PR_ORIGINAL_SENDER_ADDRTYPE. + + + The MAPI property PR_ORIGINAL_SENDER_ADDRTYPE. + + + + + The MAPI property PR_ORIGINAL_SENDER_ADDRTYPE. + + + The MAPI property PR_ORIGINAL_SENDER_ADDRTYPE. + + + + + The MAPI property PR_ORIGINAL_SENDER_EMAIL_ADDRESS. + + + The MAPI property PR_ORIGINAL_SENDER_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINAL_SENDER_EMAIL_ADDRESS. + + + The MAPI property PR_ORIGINAL_SENDER_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINAL_SENDER_ENTRYID. + + + The MAPI property PR_ORIGINAL_SENDER_ENTRYID. + + + + + The MAPI property PR_ORIGINAL_SENDER_NAME. + + + The MAPI property PR_ORIGINAL_SENDER_NAME. + + + + + The MAPI property PR_ORIGINAL_SENDER_NAME. + + + The MAPI property PR_ORIGINAL_SENDER_NAME. + + + + + The MAPI property PR_ORIGINAL_SENDER_SEARCH_KEY. + + + The MAPI property PR_ORIGINAL_SENDER_SEARCH_KEY. + + + + + The MAPI property PR_ORIGINAL_SENSITIVITY. + + + The MAPI property PR_ORIGINAL_SENSITIVITY. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE. + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE. + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS. + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS. + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_ENTRYID. + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_ENTRYID. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_NAME. + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_NAME. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_NAME. + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_NAME. + + + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_SEARCH_KEY. + + + The MAPI property PR_ORIGINAL_SENT_REPRESENTING_SEARCH_KEY. + + + + + The MAPI property PR_ORIGINAL_SUBJECT. + + + The MAPI property PR_ORIGINAL_SUBJECT. + + + + + The MAPI property PR_ORIGINAL_SUBJECT. + + + The MAPI property PR_ORIGINAL_SUBJECT. + + + + + The MAPI property PR_ORIGINAL_SUBMIT_TIME. + + + The MAPI property PR_ORIGINAL_SUBMIT_TIME. + + + + + The MAPI property PR_ORIGINATING_MTA_CERTIFICATE. + + + The MAPI property PR_ORIGINATING_MTA_CERTIFICATE. + + + + + The MAPI property PR_ORIGINATOR_AND_DL_EXPANSION_HISTORY. + + + The MAPI property PR_ORIGINATOR_AND_DL_EXPANSION_HISTORY. + + + + + The MAPI property PR_ORIGINATOR_CERTIFICATE. + + + The MAPI property PR_ORIGINATOR_CERTIFICATE. + + + + + The MAPI property PR_ORIGINATOR_DELIVERY_REPORT_REQUESTED. + + + The MAPI property PR_ORIGINATOR_DELIVERY_REPORT_REQUESTED. + + + + + The MAPI property PR_ORIGINATOR_NON_DELIVERY_REPORT_REQUESTED. + + + The MAPI property PR_ORIGINATOR_NON_DELIVERY_REPORT_REQUESTED. + + + + + The MAPI property PR_ORIGINATOR_REQUESTED_ALTERNATE_RECIPIENT. + + + The MAPI property PR_ORIGINATOR_REQUESTED_ALTERNATE_RECIPIENT. + + + + + The MAPI property PR_ORIGINATOR_RETURN_ADDRESS. + + + The MAPI property PR_ORIGINATOR_RETURN_ADDRESS. + + + + + The MAPI property PR_ORIGIN_CHECK. + + + The MAPI property PR_ORIGIN_CHECK. + + + + + The MAPI property PR_ORIG_MESSAGE_CLASS. + + + The MAPI property PR_ORIG_MESSAGE_CLASS. + + + + + The MAPI property PR_ORIG_MESSAGE_CLASS. + + + The MAPI property PR_ORIG_MESSAGE_CLASS. + + + + + The MAPI property PR_OTHER_ADDRESS_CITY. + + + The MAPI property PR_OTHER_ADDRESS_CITY. + + + + + The MAPI property PR_OTHER_ADDRESS_CITY. + + + The MAPI property PR_OTHER_ADDRESS_CITY. + + + + + The MAPI property PR_OTHER_ADDRESS_COUNTRY. + + + The MAPI property PR_OTHER_ADDRESS_COUNTRY. + + + + + The MAPI property PR_OTHER_ADDRESS_COUNTRY. + + + The MAPI property PR_OTHER_ADDRESS_COUNTRY. + + + + + The MAPI property PR_OTHER_ADDRESS_POSTAL_CODE. + + + The MAPI property PR_OTHER_ADDRESS_POSTAL_CODE. + + + + + The MAPI property PR_OTHER_ADDRESS_POSTAL_CODE. + + + The MAPI property PR_OTHER_ADDRESS_POSTAL_CODE. + + + + + The MAPI property PR_OTHER_ADDRESS_POST_OFFICE_BOX. + + + The MAPI property PR_OTHER_ADDRESS_POST_OFFICE_BOX. + + + + + The MAPI property PR_OTHER_ADDRESS_POST_OFFICE_BOX. + + + The MAPI property PR_OTHER_ADDRESS_POST_OFFICE_BOX. + + + + + The MAPI property PR_OTHER_ADDRESS_STATE_OR_PROVINCE. + + + The MAPI property PR_OTHER_ADDRESS_STATE_OR_PROVINCE. + + + + + The MAPI property PR_OTHER_ADDRESS_STATE_OR_PROVINCE. + + + The MAPI property PR_OTHER_ADDRESS_STATE_OR_PROVINCE. + + + + + The MAPI property PR_OTHER_ADDRESS_STREET. + + + The MAPI property PR_OTHER_ADDRESS_STREET. + + + + + The MAPI property PR_OTHER_ADDRESS_STREET. + + + The MAPI property PR_OTHER_ADDRESS_STREET. + + + + + The MAPI property PR_OTHER_TELEPHONE_NUMBER. + + + The MAPI property PR_OTHER_TELEPHONE_NUMBER. + + + + + The MAPI property PR_OTHER_TELEPHONE_NUMBER. + + + The MAPI property PR_OTHER_TELEPHONE_NUMBER. + + + + + The MAPI property PR_OWNER_APPT_ID. + + + The MAPI property PR_OWNER_APPT_ID. + + + + + The MAPI property PR_OWN_STORE_ENTRYID. + + + The MAPI property PR_OWN_STORE_ENTRYID. + + + + + The MAPI property PR_PAGER_TELEPHONE_NUMBER. + + + The MAPI property PR_PAGER_TELEPHONE_NUMBER. + + + + + The MAPI property PR_PAGER_TELEPHONE_NUMBER. + + + The MAPI property PR_PAGER_TELEPHONE_NUMBER. + + + + + The MAPI property PR_PARENT_DISPLAY. + + + The MAPI property PR_PARENT_DISPLAY. + + + + + The MAPI property PR_PARENT_DISPLAY. + + + The MAPI property PR_PARENT_DISPLAY. + + + + + The MAPI property PR_PARENT_ENTRYID. + + + The MAPI property PR_PARENT_ENTRYID. + + + + + The MAPI property PR_PARENT_KEY. + + + The MAPI property PR_PARENT_KEY. + + + + + The MAPI property PR_PERSONAL_HOME_PAGE. + + + The MAPI property PR_PERSONAL_HOME_PAGE. + + + + + The MAPI property PR_PERSONAL_HOME_PAGE. + + + The MAPI property PR_PERSONAL_HOME_PAGE. + + + + + The MAPI property PR_PHYSICAL_DELIVERY_BUREAU_FAX_DELIVERY. + + + The MAPI property PR_PHYSICAL_DELIVERY_BUREAU_FAX_DELIVERY. + + + + + The MAPI property PR_PHYSICAL_DELIVERY_MODE. + + + The MAPI property PR_PHYSICAL_DELIVERY_MODE. + + + + + The MAPI property PR_PHYSICAL_DELIVERY_REPORT_REQUEST. + + + The MAPI property PR_PHYSICAL_DELIVERY_REPORT_REQUEST. + + + + + The MAPI property PR_PHYSICAL_FORWARDING_ADDRESS. + + + The MAPI property PR_PHYSICAL_FORWARDING_ADDRESS. + + + + + The MAPI property PR_PHYSICAL_FORWARDING_ADDRESS_REQUESTED. + + + The MAPI property PR_PHYSICAL_FORWARDING_ADDRESS_REQUESTED. + + + + + The MAPI property PR_PHYSICAL_FORWARDING_PROHIBITED. + + + The MAPI property PR_PHYSICAL_FORWARDING_PROHIBITED. + + + + + The MAPI property PR_PHYSICAL_RENDITION_ATTRIBUTES. + + + The MAPI property PR_PHYSICAL_RENDITION_ATTRIBUTES. + + + + + The MAPI property PR_POSTAL_ADDRESS. + + + The MAPI property PR_POSTAL_ADDRESS. + + + + + The MAPI property PR_POSTAL_ADDRESS. + + + The MAPI property PR_POSTAL_ADDRESS. + + + + + The MAPI property PR_POSTAL_CODE. + + + The MAPI property PR_POSTAL_CODE. + + + + + The MAPI property PR_POSTAL_CODE. + + + The MAPI property PR_POSTAL_CODE. + + + + + The MAPI property PR_POST_FOLDER_ENTRIES. + + + The MAPI property PR_POST_FOLDER_ENTRIES. + + + + + The MAPI property PR_POST_FOLDER_NAMES. + + + The MAPI property PR_POST_FOLDER_NAMES. + + + + + The MAPI property PR_POST_FOLDER_NAMES. + + + The MAPI property PR_POST_FOLDER_NAMES. + + + + + The MAPI property PR_POST_OFFICE_BOX. + + + The MAPI property PR_POST_OFFICE_BOX. + + + + + The MAPI property PR_POST_OFFICE_BOX. + + + The MAPI property PR_POST_OFFICE_BOX. + + + + + The MAPI property PR_POST_REPLY_DENIED. + + + The MAPI property PR_POST_REPLY_DENIED. + + + + + The MAPI property PR_POST_REPLY_FOLDER_ENTRIES. + + + The MAPI property PR_POST_REPLY_FOLDER_ENTRIES. + + + + + The MAPI property PR_POST_REPLY_FOLDER_NAMES. + + + The MAPI property PR_POST_REPLY_FOLDER_NAMES. + + + + + The MAPI property PR_POST_REPLY_FOLDER_NAMES. + + + The MAPI property PR_POST_REPLY_FOLDER_NAMES. + + + + + The MAPI property PR_PREFERRED_BY_NAME. + + + The MAPI property PR_PREFERRED_BY_NAME. + + + + + The MAPI property PR_PREFERRED_BY_NAME. + + + The MAPI property PR_PREFERRED_BY_NAME. + + + + + The MAPI property PR_PREPROCESS. + + + The MAPI property PR_PREPROCESS. + + + + + The MAPI property PR_PRIMARY_CAPABILITY. + + + The MAPI property PR_PRIMARY_CAPABILITY. + + + + + The MAPI property PR_PRIMARY_FAX_NUMBER. + + + The MAPI property PR_PRIMARY_FAX_NUMBER. + + + + + The MAPI property PR_PRIMARY_FAX_NUMBER. + + + The MAPI property PR_PRIMARY_FAX_NUMBER. + + + + + The MAPI property PR_PRIMARY_TELEPHONE_NUMBER. + + + The MAPI property PR_PRIMARY_TELEPHONE_NUMBER. + + + + + The MAPI property PR_PRIMARY_TELEPHONE_NUMBER. + + + The MAPI property PR_PRIMARY_TELEPHONE_NUMBER. + + + + + The MAPI property PR_PRIORITY. + + + The MAPI property PR_PRIORITY. + + + + + The MAPI property PR_PROFESSION. + + + The MAPI property PR_PROFESSION. + + + + + The MAPI property PR_PROFESSION. + + + The MAPI property PR_PROFESSION. + + + + + The MAPI property PR_PROFILE_NAME. + + + The MAPI property PR_PROFILE_NAME. + + + + + The MAPI property PR_PROFILE_NAME. + + + The MAPI property PR_PROFILE_NAME. + + + + + The MAPI property PR_PROOF_OF_DELIVERY. + + + The MAPI property PR_PROOF_OF_DELIVERY. + + + + + The MAPI property PR_PROOF_OF_DELIVERY_REQUESTED. + + + The MAPI property PR_PROOF_OF_DELIVERY_REQUESTED. + + + + + The MAPI property PR_PROOF_OF_SUBMISSION. + + + The MAPI property PR_PROOF_OF_SUBMISSION. + + + + + The MAPI property PR_PROOF_OF_SUBMISSION_REQUESTED. + + + The MAPI property PR_PROOF_OF_SUBMISSION_REQUESTED. + + + + + The MAPI property PR_PROVIDER_DISPLAY. + + + The MAPI property PR_PROVIDER_DISPLAY. + + + + + The MAPI property PR_PROVIDER_DISPLAY. + + + The MAPI property PR_PROVIDER_DISPLAY. + + + + + The MAPI property PR_PROVIDER_DLL_NAME. + + + The MAPI property PR_PROVIDER_DLL_NAME. + + + + + The MAPI property PR_PROVIDER_DLL_NAME. + + + The MAPI property PR_PROVIDER_DLL_NAME. + + + + + The MAPI property PR_PROVIDER_ORDINAL. + + + The MAPI property PR_PROVIDER_ORDINAL. + + + + + The MAPI property PR_PROVIDER_SUBMIT_TIME. + + + The MAPI property PR_PROVIDER_SUBMIT_TIME. + + + + + The MAPI property PR_PROVIDER_UID. + + + The MAPI property PR_PROVIDER_UID. + + + + + The MAPI property PR_PUID. + + + The MAPI property PR_PUID. + + + + + The MAPI property PR_RADIO_TELEPHONE_NUMBER. + + + The MAPI property PR_RADIO_TELEPHONE_NUMBER. + + + + + The MAPI property PR_RADIO_TELEPHONE_NUMBER. + + + The MAPI property PR_RADIO_TELEPHONE_NUMBER. + + + + + The MAPI property PR_RCVD_REPRESENTING_ADDRTYPE. + + + The MAPI property PR_RCVD_REPRESENTING_ADDRTYPE. + + + + + The MAPI property PR_RCVD_REPRESENTING_ADDRTYPE. + + + The MAPI property PR_RCVD_REPRESENTING_ADDRTYPE. + + + + + The MAPI property PR_RCVD_REPRESENTING_EMAIL_ADDRESS. + + + The MAPI property PR_RCVD_REPRESENTING_EMAIL_ADDRESS. + + + + + The MAPI property PR_RCVD_REPRESENTING_EMAIL_ADDRESS. + + + The MAPI property PR_RCVD_REPRESENTING_EMAIL_ADDRESS. + + + + + The MAPI property PR_RCVD_REPRESENTING_ENTRYID. + + + The MAPI property PR_RCVD_REPRESENTING_ENTRYID. + + + + + The MAPI property PR_RCVD_REPRESENTING_NAME. + + + The MAPI property PR_RCVD_REPRESENTING_NAME. + + + + + The MAPI property PR_RCVD_REPRESENTING_NAME. + + + The MAPI property PR_RCVD_REPRESENTING_NAME. + + + + + The MAPI property PR_RCVD_REPRESENTING_SEARCH_KEY. + + + The MAPI property PR_RCVD_REPRESENTING_SEARCH_KEY. + + + + + The MAPI property PR_READ_RECEIPT_ENTRYID. + + + The MAPI property PR_READ_RECEIPT_ENTRYID. + + + + + The MAPI property PR_READ_RECEIPT_REQUESTED. + + + The MAPI property PR_READ_RECEIPT_REQUESTED. + + + + + The MAPI property PR_READ_RECEIPT_SEARCH_KEY. + + + The MAPI property PR_READ_RECEIPT_SEARCH_KEY. + + + + + The MAPI property PR_RECEIPT_TIME. + + + The MAPI property PR_RECEIPT_TIME. + + + + + The MAPI property PR_RECEIVED_BY_ADDRTYPE. + + + The MAPI property PR_RECEIVED_BY_ADDRTYPE. + + + + + The MAPI property PR_RECEIVED_BY_ADDRTYPE. + + + The MAPI property PR_RECEIVED_BY_ADDRTYPE. + + + + + The MAPI property PR_RECEIVED_BY_EMAIL_ADDRESS. + + + The MAPI property PR_RECEIVED_BY_EMAIL_ADDRESS. + + + + + The MAPI property PR_RECEIVED_BY_EMAIL_ADDRESS. + + + The MAPI property PR_RECEIVED_BY_EMAIL_ADDRESS. + + + + + The MAPI property PR_RECEIVED_BY_ENTRYID. + + + The MAPI property PR_RECEIVED_BY_ENTRYID. + + + + + The MAPI property PR_RECEIVED_BY_NAME. + + + The MAPI property PR_RECEIVED_BY_NAME. + + + + + The MAPI property PR_RECEIVED_BY_NAME. + + + The MAPI property PR_RECEIVED_BY_NAME. + + + + + The MAPI property PR_RECEIVED_BY_SEARCH_KEY. + + + The MAPI property PR_RECEIVED_BY_SEARCH_KEY. + + + + + The MAPI property PR_RECEIVE_FOLDER_SETTINGS. + + + The MAPI property PR_RECEIVE_FOLDER_SETTINGS. + + + + + The MAPI property PR_RECIPIENT_CERTIFICATE. + + + The MAPI property PR_RECIPIENT_CERTIFICATE. + + + + + The MAPI property PR_RECIPIENT_DISPLAY_NAME. + + + The MAPI property PR_RECIPIENT_DISPLAY_NAME. + + + + + The MAPI property PR_RECIPIENT_DISPLAY_NAME. + + + The MAPI property PR_RECIPIENT_DISPLAY_NAME. + + + + + The MAPI property PR_RECIPIENT_NUMBER_FOR_ADVICE. + + + The MAPI property PR_RECIPIENT_NUMBER_FOR_ADVICE. + + + + + The MAPI property PR_RECIPIENT_NUMBER_FOR_ADVICE. + + + The MAPI property PR_RECIPIENT_NUMBER_FOR_ADVICE. + + + + + The MAPI property PR_RECIPIENT_REASSIGNMENT_PROHIBITED. + + + The MAPI property PR_RECIPIENT_REASSIGNMENT_PROHIBITED. + + + + + The MAPI property PR_RECIPIENT_STATUS. + + + The MAPI property PR_RECIPIENT_STATUS. + + + + + The MAPI property PR_RECIPIENT_TYPE. + + + The MAPI property PR_RECIPIENT_TYPE. + + + + + The MAPI property PR_REDIRECTION_HISTORY. + + + The MAPI property PR_REDIRECTION_HISTORY. + + + + + The MAPI property PR_REFERRED_BY_NAME. + + + The MAPI property PR_REFERRED_BY_NAME. + + + + + The MAPI property PR_REFERRED_BY_NAME. + + + The MAPI property PR_REFERRED_BY_NAME. + + + + + The MAPI property PR_REGISTERED_MAIL_TYPE. + + + The MAPI property PR_REGISTERED_MAIL_TYPE. + + + + + The MAPI property PR_RELATED_IPMS. + + + The MAPI property PR_RELATED_IPMS. + + + + + The MAPI property PR_REMOTE_PROGRESS. + + + The MAPI property PR_REMOTE_PROGRESS. + + + + + The MAPI property PR_REMOTE_PROGRESS_TEXT. + + + The MAPI property PR_REMOTE_PROGRESS_TEXT. + + + + + The MAPI property PR_REMOTE_PROGRESS_TEXT. + + + The MAPI property PR_REMOTE_PROGRESS_TEXT. + + + + + The MAPI property PR_REMOTE_VALIDATE_OK. + + + The MAPI property PR_REMOTE_VALIDATE_OK. + + + + + The MAPI property PR_RENDERING_POSITION. + + + The MAPI property PR_RENDERING_POSITION. + + + + + The MAPI property PR_REPLY_RECIPIENT_ENTRIES. + + + The MAPI property PR_REPLY_RECIPIENT_ENTRIES. + + + + + The MAPI property PR_REPLY_RECIPIENT_NAMES. + + + The MAPI property PR_REPLY_RECIPIENT_NAMES. + + + + + The MAPI property PR_REPLY_RECIPIENT_NAMES. + + + The MAPI property PR_REPLY_RECIPIENT_NAMES. + + + + + The MAPI property PR_REPLY_REQUESTED. + + + The MAPI property PR_REPLY_REQUESTED. + + + + + The MAPI property PR_REPLY_TIME. + + + The MAPI property PR_REPLY_TIME. + + + + + The MAPI property PR_REPORT_ENTRYID. + + + The MAPI property PR_REPORT_ENTRYID. + + + + + The MAPI property PR_REPORTING_DL_NAME. + + + The MAPI property PR_REPORTING_DL_NAME. + + + + + The MAPI property PR_REPORTING_MTA_CERTIFICATE. + + + The MAPI property PR_REPORTING_MTA_CERTIFICATE. + + + + + The MAPI property PR_REPORT_NAME. + + + The MAPI property PR_REPORT_NAME. + + + + + The MAPI property PR_REPORT_NAME. + + + The MAPI property PR_REPORT_NAME. + + + + + The MAPI property PR_REPORT_SEARCH_KEY. + + + The MAPI property PR_REPORT_SEARCH_KEY. + + + + + The MAPI property PR_REPORT_TAG. + + + The MAPI property PR_REPORT_TAG. + + + + + The MAPI property PR_REPORT_TEXT. + + + The MAPI property PR_REPORT_TEXT. + + + + + The MAPI property PR_REPORT_TEXT. + + + The MAPI property PR_REPORT_TEXT. + + + + + The MAPI property PR_REPORT_TIME. + + + The MAPI property PR_REPORT_TIME. + + + + + The MAPI property PR_REQUESTED_DELIVERY_METHOD. + + + The MAPI property PR_REQUESTED_DELIVERY_METHOD. + + + + + The MAPI property PR_RESOURCE_FLAGS. + + + The MAPI property PR_RESOURCE_FLAGS. + + + + + The MAPI property PR_RESOURCE_METHODS. + + + The MAPI property PR_RESOURCE_METHODS. + + + + + The MAPI property PR_RESOURCE_PATH. + + + The MAPI property PR_RESOURCE_PATH. + + + + + The MAPI property PR_RESOURCE_PATH. + + + The MAPI property PR_RESOURCE_PATH. + + + + + The MAPI property PR_RESOURCE_TYPE. + + + The MAPI property PR_RESOURCE_TYPE. + + + + + The MAPI property PR_RESPONSE_REQUESTED. + + + The MAPI property PR_RESPONSE_REQUESTED. + + + + + The MAPI property PR_RESPONSIBILITY. + + + The MAPI property PR_RESPONSIBILITY. + + + + + The MAPI property PR_RETURNED_IPM. + + + The MAPI property PR_RETURNED_IPM. + + + + + The MAPI property PR_ROWID. + + + The MAPI property PR_ROWID. + + + + + The MAPI property PR_ROW_TYPE. + + + The MAPI property PR_ROW_TYPE. + + + + + The MAPI property PR_RTF_COMPRESSED. + + + The MAPI property PR_RTF_COMPRESSED. + + + + + The MAPI property PR_RTF_IN_SYNC. + + + The MAPI property PR_RTF_IN_SYNC. + + + + + The MAPI property PR_RTF_SYNC_BODY_COUNT. + + + The MAPI property PR_RTF_SYNC_BODY_COUNT. + + + + + The MAPI property PR_RTF_SYNC_BODY_CRC. + + + The MAPI property PR_RTF_SYNC_BODY_CRC. + + + + + The MAPI property PR_RTF_SYNC_BODY_TAG. + + + The MAPI property PR_RTF_SYNC_BODY_TAG. + + + + + The MAPI property PR_RTF_SYNC_BODY_TAG. + + + The MAPI property PR_RTF_SYNC_BODY_TAG. + + + + + The MAPI property PR_RTF_SYNC_PREFIX_COUNT. + + + The MAPI property PR_RTF_SYNC_PREFIX_COUNT. + + + + + The MAPI property PR_RTF_SYNC_TRAILING_COUNT. + + + The MAPI property PR_RTF_SYNC_TRAILING_COUNT. + + + + + The MAPI property PR_SEARCH. + + + The MAPI property PR_SEARCH. + + + + + The MAPI property PR_SEARCH_KEY. + + + The MAPI property PR_SEARCH_KEY. + + + + + The MAPI property PR_SECURITY. + + + The MAPI property PR_SECURITY. + + + + + The MAPI property PR_SELECTABLE. + + + The MAPI property PR_SELECTABLE. + + + + + The MAPI property PR_SENDER_ADDRTYPE. + + + The MAPI property PR_SENDER_ADDRTYPE. + + + + + The MAPI property PR_SENDER_ADDRTYPE. + + + The MAPI property PR_SENDER_ADDRTYPE. + + + + + The MAPI property PR_SENDER_EMAIL_ADDRESS. + + + The MAPI property PR_SENDER_EMAIL_ADDRESS. + + + + + The MAPI property PR_SENDER_EMAIL_ADDRESS. + + + The MAPI property PR_SENDER_EMAIL_ADDRESS. + + + + + The MAPI property PR_SENDER_ENTRYID. + + + The MAPI property PR_SENDER_ENTRYID. + + + + + The MAPI property PR_SENDER_NAME. + + + The MAPI property PR_SENDER_NAME. + + + + + The MAPI property PR_SENDER_NAME. + + + The MAPI property PR_SENDER_NAME. + + + + + The MAPI property PR_SENDER_SEARCH_KEY. + + + The MAPI property PR_SENDER_SEARCH_KEY. + + + + + The MAPI property PR_SEND_INTERNET_ENCODING. + + + The MAPI property PR_SEND_INTERNET_ENCODING. + + + + + The MAPI property PR_SEND_RECALL_REPORT + + + The MAPI property PR_SEND_RECALL_REPORT. + + + + + The MAPI property PR_SEND_RICH_INFO. + + + The MAPI property PR_SEND_RICH_INFO. + + + + + The MAPI property PR_SENSITIVITY. + + + The MAPI property PR_SENSITIVITY. + + + + + The MAPI property PR_SENTMAIL_ENTRYID. + + + The MAPI property PR_SENTMAIL_ENTRYID. + + + + + The MAPI property PR_SENT_REPRESENTING_ADDRTYPE. + + + The MAPI property PR_SENT_REPRESENTING_ADDRTYPE. + + + + + The MAPI property PR_SENT_REPRESENTING_ADDRTYPE. + + + The MAPI property PR_SENT_REPRESENTING_ADDRTYPE. + + + + + The MAPI property PR_SENT_REPRESENTING_EMAIL_ADDRESS. + + + The MAPI property PR_SENT_REPRESENTING_EMAIL_ADDRESS. + + + + + The MAPI property PR_SENT_REPRESENTING_EMAIL_ADDRESS. + + + The MAPI property PR_SENT_REPRESENTING_EMAIL_ADDRESS. + + + + + The MAPI property PR_SENT_REPRESENTING_ENTRYID. + + + The MAPI property PR_SENT_REPRESENTING_ENTRYID. + + + + + The MAPI property PR_SENT_REPRESENTING_NAME. + + + The MAPI property PR_SENT_REPRESENTING_NAME. + + + + + The MAPI property PR_SENT_REPRESENTING_NAME. + + + The MAPI property PR_SENT_REPRESENTING_NAME. + + + + + The MAPI property PR_SENT_REPRESENTING_SEARCH_KEY. + + + The MAPI property PR_SENT_REPRESENTING_SEARCH_KEY. + + + + + The MAPI property PR_SERVICE_DELETE_FILES. + + + The MAPI property PR_SERVICE_DELETE_FILES. + + + + + The MAPI property PR_SERVICE_DELETE_FILES. + + + The MAPI property PR_SERVICE_DELETE_FILES. + + + + + The MAPI property PR_SERVICE_DLL_NAME. + + + The MAPI property PR_SERVICE_DLL_NAME. + + + + + The MAPI property PR_SERVICE_DLL_NAME. + + + The MAPI property PR_SERVICE_DLL_NAME. + + + + + The MAPI property PR_SERVICE_ENTRY_NAME. + + + The MAPI property PR_SERVICE_ENTRY_NAME. + + + + + The MAPI property PR_SERVICE_EXTRA_UIDS. + + + The MAPI property PR_SERVICE_EXTRA_UIDS. + + + + + The MAPI property PR_SERVICE_NAME. + + + The MAPI property PR_SERVICE_NAME. + + + + + The MAPI property PR_SERVICE_NAME. + + + The MAPI property PR_SERVICE_NAME. + + + + + The MAPI property PR_SERVICES. + + + The MAPI property PR_SERVICES. + + + + + The MAPI property PR_SERVICE_SUPPORT_FILES. + + + The MAPI property PR_SERVICE_SUPPORT_FILES. + + + + + The MAPI property PR_SERVICE_SUPPORT_FILES. + + + The MAPI property PR_SERVICE_SUPPORT_FILES. + + + + + The MAPI property PR_SERVICE_UID. + + + The MAPI property PR_SERVICE_UID. + + + + + The MAPI property PR_SEVEN_BIT_DISPLAY_NAME. + + + The MAPI property PR_SEVEN_BIT_DISPLAY_NAME. + + + + + The MAPI property PR_SMTP_ADDRESS. + + + The MAPI property PR_SMTP_ADDRESS. + + + + + The MAPI property PR_SMTP_ADDRESS. + + + The MAPI property PR_SMTP_ADDRESS. + + + + + The MAPI property PR_SPOOLER_STATUS. + + + The MAPI property PR_SPOOLER_STATUS. + + + + + The MAPI property PR_SPOUSE_NAME. + + + The MAPI property PR_SPOUSE_NAME. + + + + + The MAPI property PR_SPOUSE_NAME. + + + The MAPI property PR_SPOUSE_NAME. + + + + + The MAPI property PR_START_DATE. + + + The MAPI property PR_START_DATE. + + + + + The MAPI property PR_STATE_OR_PROVINCE. + + + The MAPI property PR_STATE_OR_PROVINCE. + + + + + The MAPI property PR_STATE_OR_PROVINCE. + + + The MAPI property PR_STATE_OR_PROVINCE. + + + + + The MAPI property PR_STATUS. + + + The MAPI property PR_STATUS. + + + + + The MAPI property PR_STATUS_CODE. + + + The MAPI property PR_STATUS_CODE. + + + + + The MAPI property PR_STATUS_STRING. + + + The MAPI property PR_STATUS_STRING. + + + + + The MAPI property PR_STATUS_STRING. + + + The MAPI property PR_STATUS_STRING. + + + + + The MAPI property PR_STORE_ENTRYID. + + + The MAPI property PR_STORE_ENTRYID. + + + + + The MAPI property PR_STORE_PROVIDERS. + + + The MAPI property PR_STORE_PROVIDERS. + + + + + The MAPI property PR_STORE_RECORD_KEY. + + + The MAPI property PR_STORE_RECORD_KEY. + + + + + The MAPI property PR_STORE_STATE. + + + The MAPI property PR_STORE_STATE. + + + + + The MAPI property PR_STORE_SUPPORT_MASK. + + + The MAPI property PR_STORE_SUPPORT_MASK. + + + + + The MAPI property PR_STREET_ADDRESS. + + + The MAPI property PR_STREET_ADDRESS. + + + + + The MAPI property PR_STREET_ADDRESS. + + + The MAPI property PR_STREET_ADDRESS. + + + + + The MAPI property PR_SUBFOLDERS. + + + The MAPI property PR_SUBFOLDERS. + + + + + The MAPI property PR_SUBJECT. + + + The MAPI property PR_SUBJECT. + + + + + The MAPI property PR_SUBJECT. + + + The MAPI property PR_SUBJECT. + + + + + The MAPI property PR_SUBJECT_IPM. + + + The MAPI property PR_SUBJECT_IPM. + + + + + The MAPI property PR_SUBJECT_PREFIX. + + + The MAPI property PR_SUBJECT_PREFIX. + + + + + The MAPI property PR_SUBJECT_PREFIX. + + + The MAPI property PR_SUBJECT_PREFIX. + + + + + The MAPI property PR_SUBMIT_FLAGS. + + + The MAPI property PR_SUBMIT_FLAGS. + + + + + The MAPI property PR_SUPERSEDES. + + + The MAPI property PR_SUPERSEDES. + + + + + The MAPI property PR_SUPERSEDES. + + + The MAPI property PR_SUPERSEDES. + + + + + The MAPI property PR_SUPPLEMENTARY_INFO. + + + The MAPI property PR_SUPPLEMENTARY_INFO. + + + + + The MAPI property PR_SUPPLEMENTARY_INFO. + + + The MAPI property PR_SUPPLEMENTARY_INFO. + + + + + The MAPI property PR_SURNAME. + + + The MAPI property PR_SURNAME. + + + + + The MAPI property PR_SURNAME. + + + The MAPI property PR_SURNAME. + + + + + The MAPI property PR_TELEX_NUMBER. + + + The MAPI property PR_TELEX_NUMBER. + + + + + The MAPI property PR_TELEX_NUMBER. + + + The MAPI property PR_TELEX_NUMBER. + + + + + The MAPI property PR_TEMPLATEID. + + + The MAPI property PR_TEMPLATEID. + + + + + The MAPI property PR_TITLE. + + + The MAPI property PR_TITLE. + + + + + The MAPI property PR_TITLE. + + + The MAPI property PR_TITLE. + + + + + The MAPI property PR_TNEF_CORRELATION_KEY. + + + The MAPI property PR_TNEF_CORRELATION_KEY. + + + + + The MAPI property PR_TRANSMITABLE_DISPLAY_NAME. + + + The MAPI property PR_TRANSMITABLE_DISPLAY_NAME. + + + + + The MAPI property PR_TRANSMITABLE_DISPLAY_NAME. + + + The MAPI property PR_TRANSMITABLE_DISPLAY_NAME. + + + + + The MAPI property PR_TRANSPORT_KEY. + + + The MAPI property PR_TRANSPORT_KEY. + + + + + The MAPI property PR_TRANSPORT_MESSAGE_HEADERS. + + + The MAPI property PR_TRANSPORT_MESSAGE_HEADERS. + + + + + The MAPI property PR_TRANSPORT_MESSAGE_HEADERS. + + + The MAPI property PR_TRANSPORT_MESSAGE_HEADERS. + + + + + The MAPI property PR_TRANSPORT_PROVIDERS. + + + The MAPI property PR_TRANSPORT_PROVIDERS. + + + + + The MAPI property PR_TRANSPORT_STATUS. + + + The MAPI property PR_TRANSPORT_STATUS. + + + + + The MAPI property PR_TTYDD_PHONE_NUMBER. + + + The MAPI property PR_TTYDD_PHONE_NUMBER. + + + + + The MAPI property PR_TTYDD_PHONE_NUMBER. + + + The MAPI property PR_TTYDD_PHONE_NUMBER. + + + + + The MAPI property PR_TYPE_OF_MTS_USER. + + + The MAPI property PR_TYPE_OF_MTS_USER. + + + + + The MAPI property PR_USER_CERTIFICATE. + + + The MAPI property PR_USER_CERTIFICATE. + + + + + The MAPI property PR_USER_X509_CERTIFICATE. + + + The MAPI property PR_USER_X509_CERTIFICATE. + + + + + The MAPI property PR_VALID_FOLDER_MASK. + + + The MAPI property PR_VALID_FOLDER_MASK. + + + + + The MAPI property PR_VIEWS_ENTRYID. + + + The MAPI property PR_VIEWS_ENTRYID. + + + + + The MAPI property PR_WEDDING_ANNIVERSARY. + + + The MAPI property PR_WEDDING_ANNIVERSARY. + + + + + The MAPI property PR_X400_CONTENT_TYPE. + + + The MAPI property PR_X400_CONTENT_TYPE. + + + + + The MAPI property PR_X400_DEFERRED_DELIVERY_CANCEL. + + + The MAPI property PR_X400_DEFERRED_DELIVERY_CANCEL. + + + + + The MAPI property PR_XPOS. + + + The MAPI property PR_XPOS. + + + + + The MAPI property PR_YPOS. + + + The MAPI property PR_YPOS. + + + + + Get the property identifier. + + + Gets the property identifier. + + The identifier. + + + + Get a value indicating whether or not the property contains multiple values. + + + Gets a value indicating whether or not the property contains multiple values. + + true if the property contains multiple values; otherwise, false. + + + + Get a value indicating whether or not the property has a special name. + + + Gets a value indicating whether or not the property has a special name. + + true if the property has a special name; otherwise, false. + + + + Get a value indicating whether the property value type is valid. + + + Gets a value indicating whether the property value type is valid. + + true if the property value type is valid; otherwise, false. + + + + Get the property's value type (including the multi-valued bit). + + + Gets the property's value type (including the multi-valued bit). + + The property's value type. + + + + Get the type of the value that the property contains. + + + Gets the type of the value that the property contains. + + The type of the value. + + + + Initialize a new instance of the struct. + + + Creates a new based on a 32-bit integer tag as read from + a TNEF stream. + + The property tag. + + + + Initialize a new instance of the struct. + + + Creates a new based on a + and . + + The property identifier. + The property type. + + + + Cast an integer tag value into a TNEF property tag. + + + Casts an integer tag value into a TNEF property tag. + + A that represents the integer tag value. + The integer tag value. + + + + Cast a TNEF property tag into a 32-bit integer value. + + + Casts a TNEF property tag into a 32-bit integer value. + + A 32-bit integer value representing the TNEF property tag. + The TNEF property tag. + + + + Serves as a hash function for a object. + + + Serves as a hash function for a object. + + A hash code for this instance that is suitable for use in hashing algorithms + and data structures such as a hash table. + + + + Determine whether the specified is equal to the current . + + + 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. + + + + Return a that represents the current . + + + Returns a that represents the current . + + A that represents the current . + + + + Return a new where the type has been changed to . + + + Returns a new where the type has been changed to . + + The unicode equivalent of the property tag. + + + + Compare two objects for equality. + + + Compares two objects for equality. + + The first object to compare. + The second object to compare. + true if and are equal; otherwise, false. + + + + Compare two objects for inequality. + + + Compares two objects for inequality. + + The first object to compare. + The second object to compare. + true if and are unequal; otherwise, false. + + + + The type of value that a TNEF property contains. + + + The type of value that a TNEF property contains. + + + + + The type of the property is unspecified. + + + + + The property has a null value. + + + + + The property has a signed 16-bit value. + + + + + The property has a signed 32-bit value. + + + + + The property has a 32-bit floating point value. + + + + + The property has a 64-bit floating point value. + + + + + The property has a 64-bit integer value representing 1/10000th of a monetary unit (i.e., 1/100th of a cent). + + + + + The property has a 64-bit integer value specifying the number of 100ns periods since Jan 1, 1601. + + + + + The property has a 32-bit error value. + + + + + The property has a boolean value. + + + + + The property has an embedded object value. + + + + + The property has a signed 64-bit value. + + + + + The property has a null-terminated 8-bit character string value. + + + + + The property has a null-terminated unicode character string value. + + + + + The property has a 64-bit integer value specifying the number of 100ns periods since Jan 1, 1601. + + + + + The property has an OLE GUID value. + + + + + The property has a binary blob value. + + + + + A flag indicating that the property contains multiple values. + + + + + A TNEF reader. + + + A TNEF reader. + + + + + Get the attachment key value. + + + Gets the attachment key value. + + The attachment key value. + + + + Get the current attribute's level. + + + Gets the current attribute's level. + + The current attribute's level. + + + + Get the length of the current attribute's raw value. + + + Gets the length of the current attribute's raw value. + + The length of the current attribute's raw value. + + + + Get the stream offset of the current attribute's raw value. + + + Gets the stream offset of the current attribute's raw value. + + The stream offset of the current attribute's raw value. + + + + Get the current attribute's tag. + + + Gets the current attribute's tag. + + The current attribute's tag. + + + + Get the compliance mode. + + + Gets the compliance mode. + + The compliance mode. + + + + Get the current compliance status of the TNEF stream. + + + Gets the current compliance status of the TNEF stream. + As the reader progresses, this value may change if errors are encountered. + + The compliance status. + + + + Get the message codepage. + + + Gets the message codepage. + + The message codepage. + + + + Get the TNEF property reader. + + + Gets the TNEF property reader. + + The TNEF property reader. + + + + Get the current stream offset. + + + Gets the current stream offset. + + The stream offset. + + + + Get the TNEF version. + + + Gets the TNEF version. + + The TNEF version. + + + + Initialize a new instance of the class. + + + When reading a TNEF stream using the mode, + a will be thrown immediately at the first sign of + invalid or corrupted data. + When reading a TNEF stream using the mode, + however, compliance issues are accumulated in the + property, but exceptions are not raised unless the stream is too corrupted to continue. + + The input stream. + The default message codepage. + The compliance mode. + + is null. + + + is not a valid codepage. + + + is not a supported codepage. + + + The TNEF stream is corrupted or invalid. + + + + + Initialize a new instance of the class. + + + Creates a new for the specified input stream. + + The input stream. + + is null. + + + + + Releases unmanaged resources and performs other cleanup operations before the + is reclaimed by garbage collection. + + + Releases unmanaged resources and performs other cleanup operations before the + is reclaimed by garbage collection. + + + + + Advance to the next attribute in the TNEF stream. + + + Advances to the next attribute in the TNEF stream. + + true if there is another attribute available to be read; otherwise false. + + The TNEF stream is corrupted or invalid. + + + + + Read the raw attribute value data from the underlying TNEF stream. + + + Reads the raw attribute value data from the underlying TNEF stream. + + The total number of bytes read into the buffer. This can be less than the number + of bytes requested if that many bytes are not available, or zero (0) if the end of the + value has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + An I/O error occurred. + + + + + Reset the compliance status. + + + Resets the compliance status. + + + + + Close the TNEF reader and the underlying stream. + + + Closes the TNEF reader and the underlying stream. + + + + + Release the unmanaged resources used by the and + optionally releases the managed resources. + + + 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 the unmanaged resources. + + + + Release all resource used by the object. + + Call when you are finished using the . The + method leaves the in an unusable state. After calling + , you must release all references to the so the garbage + collector can reclaim the memory that the was occupying. + + + + A stream for reading raw values from a or . + + + A stream for reading raw values from a or . + + + + + Initialize a new instance of the class. + + + Creates a stream for reading a raw value from the . + + The . + The end offset of the data. + The end offset of the container value. + + + + Check whether or not the stream supports reading. + + + The is always readable. + + true if the stream supports reading; otherwise, false. + + + + Check whether or not the stream supports writing. + + + Writing to a is not supported. + + true if the stream supports writing; otherwise, false. + + + + Check whether or not the stream supports seeking. + + + Seeking within a is not supported. + + true if the stream supports seeking; otherwise, false. + + + + Get the length of the stream, in bytes. + + + Getting the length of a is not supported. + + The length of the stream in bytes. + + The stream does not support seeking. + + + + + Get or sets the current position within the stream. + + + Getting and setting the position of a is not supported. + + The position of the stream. + + The stream does not support seeking. + + + + + Read a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + + Reads a sequence of bytes from the stream and advances the position + within the stream by the number of bytes read. + + The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many + bytes are not currently available, or zero (0) if the end of the stream has been reached. + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + The stream has been disposed. + + + An I/O error occurred. + + + + + Write a sequence of bytes to the stream and advances the current + position within this stream by the number of bytes written. + + + The does not support writing. + + The buffer to write. + The offset of the first byte to write. + The number of bytes to write. + + The stream does not support writing. + + + + + Set the position within the current stream. + + + The does not support seeking. + + The new position within the stream. + The offset into the stream relative to the . + The origin to seek from. + + The stream does not support seeking. + + + + + Clear all buffers for this stream and causes any buffered data to be written + to the underlying device. + + + The does not support writing. + + + The stream does not support writing. + + + + + Set the length of the stream. + + + The does not support setting the length. + + The desired length of the stream in bytes. + + The stream does not support setting the length. + + + + + Release the unmanaged resources used by the and + optionally releases the managed resources. + + + The underlying is not disposed. + + true to release both managed and unmanaged resources; + false to release only the unmanaged resources. + + + + Provides a pool of reusable buffers. + + + + Renting and returning buffers with a can increase performance + in situations where buffers are created and destroyed frequently, resulting in significant + memory pressure on the garbage collector. + + + This class is thread-safe. All members may be used by multiple threads concurrently. + + + + + + Initialize a new instance of the class. + + + Creates a new buffer pool. + + The buffer size. + The maximum number of buffers that should be retained by the pool. + + is less than 1. + -or- + is less than 1. + + + + + Get the size of the buffers returned and/or retained by the pool. + + + Gets the size of the buffers returned and/or retained by the pool. + + The size of the buffer. + + + + Get the maximum number of buffers that the pool should retain. + + + Gets the maximum number of buffers that the pool should retain. + + The max buffer count. + + + + Rent a buffer from the pool. + + + Returns a buffer from the pool. This buffer should later be returned back to the pool using + when the caller is finished using it so that it may be reused + in subsequent uses of . + + The rented buffer. + true if the buffer should be cleared; otherwise, false. + + + + Return the specified buffer to the pool. + + + Once a buffer has been returned to the pool, the caller gives up all ownership of the buffer + and must not use it. The reference returned from a given call to must + only be returned via once. The default + may hold onto the returned buffer in order to rent it again, or it may release the returned buffer + if it is determined that the pool already contains the maximum number of buffers as specified by + . + + The buffer. + + is null. + + + The size of the does not match . + + + + + The 32-bit cyclic redundancy check (CRC) algorithm. + + + A cyclic redundancy check is a form of integrity check to make sure + that a block of data has not been corrupted. + + + + + Initialize a new instance of the class. + + + Creates a new CRC32 context. + + The initial value. + + + + Clone the CRC32 context and state. + + + Clones the CRC32 context and state. + + + + + Get the computed checksum. + + + Gets the computed checksum. + + The checksum. + + + + Update the CRC based on the specified block of data. + + + Updates the CRC based on the specified block of data. + + The buffer to read data into. + The offset into the buffer to start reading data. + The number of bytes to read. + + is null. + + + is less than zero or greater than the length of . + -or- + The is not large enough to contain bytes starting + at the specified . + + + + + Update the CRC based on the specified byte. + + + Updates the CRC based on the specified byte. + + The byte value. + + + + Reset the checksum so that the context can be reused. + + + Resets the checksum so that the context can be reused. + + + + + Utility methods to parse and format rfc822 date strings. + + + Utility methods to parse and format rfc822 date strings. + + + + + Try to parse the given input buffer into a new instance. + + + Parses an rfc822 date and time from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + true, if the date was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The number of bytes in the input buffer to parse. + The parsed date. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses an rfc822 date and time from the supplied buffer starting at the specified index. + + true, if the date was successfully parsed, false otherwise. + The input buffer. + The starting index of the input buffer. + The parsed date. + + is null. + + + is not within the range of the byte array. + + + + + Try to parse the given input buffer into a new instance. + + + Parses an rfc822 date and time from the specified buffer. + + true, if the date was successfully parsed, false otherwise. + The input buffer. + The parsed date. + + is null. + + + + + Try to parse the given input buffer into a new instance. + + + Parses an rfc822 date and time from the specified text. + + true, if the date was successfully parsed, false otherwise. + The input text. + The parsed date. + + is null. + + + + + Format the as an rfc822 date string. + + + Formats the date and time in the format specified by rfc822, suitable for use + in the Date header of MIME messages. + + The formatted string. + The date. + + + + MIME utility methods. + + + Various utility methods that don't belong anywhere else. + + + + + A string comparer that performs a case-insensitive ordinal string comparison. + + + A string comparer that performs a case-insensitive ordinal string comparison. + + + + + Generate a Message-Id or Content-Id. + + + Generates a new Message-Id (or Content-Id) using the supplied domain. + + The message identifier. + A domain to use. + + is null. + + + is invalid. + + + + + Generate a Message-Id or Content-Id. + + + Generates a new Message-Id (or Content-Id) using the local machine's domain. + + The message identifier. + + + + Enumerate the Message-Id references such as those that can be found in + the In-Reply-To or References headers. + + + Incrementally parses Message-Ids (such as those from a References header + in a MIME message) from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + The references. + The raw byte buffer to parse. + The index into the buffer to start parsing. + The length of the buffer to parse. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Enumerate the Message-Id references such as those that can be found in + the In-Reply-To or References headers. + + + Incrementally parses Message-Ids (such as those from a References header + in a MIME message) from the specified text. + + The references. + The text to parse. + + is null. + + + + + Parse a Message-Id or Content-Id header value. + + + Parses the Message-Id (or Content-Id) value, returning the addr-spec portion of the msg-id token. + + The addr-spec portion of the msg-id token. + The raw byte buffer to parse. + The index into the buffer to start parsing. + The length of the buffer to parse. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Parse a Message-Id or Content-Id header value. + + + Parses the Message-Id (or Content-Id) value, returning the addr-spec portion of the msg-id token. + + The addr-spec portion of the msg-id token. + The text to parse. + + is null. + + + + + Try to parse a version from a header such as Mime-Version. + + + Parses a MIME version string from the supplied buffer starting at the given index + and spanning across the specified number of bytes. + + true, if the version was successfully parsed, false otherwise. + The raw byte buffer to parse. + The index into the buffer to start parsing. + The length of the buffer to parse. + The parsed version. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Try to parse a version from a header such as Mime-Version. + + + Parses a MIME version string from the specified text. + + true, if the version was successfully parsed, false otherwise. + The text to parse. + The parsed version. + + is null. + + + + + Try to parse the value of a Content-Transfer-Encoding header. + + + Parses a Content-Transfer-Encoding header value. + + true, if the encoding was successfully parsed, false otherwise. + The text to parse. + The parsed encoding. + + is null. + + + + + Quote the specified text and append it into the string builder. + + + Quotes the specified text, enclosing it in double-quotes and escaping + any backslashes and double-quotes within. + + The string builder. + The string builder. + The text to quote. + + is null. + -or- + is null. + + + + + Quote the specified text and append it into the value string builder. + + + Quotes the specified text, enclosing it in double-quotes and escaping + any backslashes and double-quotes within. + + The value string builder. + The text to quote. + + + + Quote the specified text and append it into the value string builder. + + + Quotes the specified text, enclosing it in double-quotes and escaping + any backslashes and double-quotes within. + + The value string builder. + The text to quote. + + + + Quote the specified text. + + + Quotes the specified text, enclosing it in double-quotes and escaping + any backslashes and double-quotes within. + + The quoted text. + The text to quote. + + is null. + + + + + Quote the specified text. + + + Quotes the specified text, enclosing it in double-quotes and escaping + any backslashes and double-quotes within. + + The quoted text. + The text to quote. + + is null. + + + + + Unquote the specified text. + + + Unquotes the specified text, removing any escaped backslashes within. + + The unquoted text. + The text to unquote. + true if tab characters should be converted to a space; otherwise, false. + + is null. + + + + + Tokenize the values in the input instance using a specified separator. + + + Tokenizes the values in the input instance using a specified separator. + This extension should be used directly within a loop: + + ReadOnlySpan<char> text = "Hello, world!"; + + foreach (var token in text.Tokenize(',')) + { + // Access the tokens here... + } + + The compiler will take care of properly setting up the loop with the type returned from this method. + The returned value shouldn't be used directly: use this extension in a loop. + + The type of items in the to tokenize. + A tokenizer for . + The source to tokenize. + The separator item to use. + + + + Tokenize the values in the input instance using a specified separator. + + + Tokenizes the values in the input instance using a specified separator. + This extension should be used directly within a loop: + + string text = "Hello, world!"; + + foreach (var token in text.Tokenize(',')) + { + // Access the tokens here... + } + + The compiler will take care of properly setting up the loop with the type returned from this method. + The returned value shouldn't be used directly: use this extension in a loop. + + A tokenizer for . + The source to tokenize. + The separator character to use. + + + + A that tokenizes a given instance. + + The type of items to enumerate. + + + + The source instance. + + + + + The separator item to use. + + + + + The current initial offset. + + + + + The current final offset. + + + + + Initializes a new instance of the struct. + + The source instance. + The separator item to use. + + + + Implements the duck-typed method. + + A instance targeting the current value. + + + + Implements the duck-typed method. + + when a new element is available, otherwise + + + + Gets the duck-typed property. + + + + + Utility methods for encoding and decoding rfc2047 encoded-word tokens. + + + Utility methods for encoding and decoding rfc2047 encoded-word tokens. + + + + + Decode a phrase. + + + Decodes the phrase(s) starting at the given index and spanning across + the specified number of bytes using the supplied parser options. + + The decoded phrase. + The parser options to use. + The phrase to decode. + The starting index. + The number of bytes to decode. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Decode a phrase. + + + Decodes the phrase(s) starting at the given index and spanning across + the specified number of bytes using the default parser options. + + The decoded phrase. + The phrase to decode. + The starting index. + The number of bytes to decode. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Decode a phrase. + + + Decodes the phrase(s) within the specified buffer using the supplied parser options. + + The decoded phrase. + The parser options to use. + The phrase to decode. + + is null. + -or- + is null. + + + + + Decode a phrase. + + + Decodes the phrase(s) within the specified buffer using the default parser options. + + The decoded phrase. + The phrase to decode. + + is null. + + + + + Decode unstructured text. + + + Decodes the unstructured text buffer starting at the given index and spanning + across the specified number of bytes using the supplied parser options. + + The decoded text. + The parser options to use. + The text to decode. + The starting index. + The number of bytes to decode. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Decode unstructured text. + + + Decodes the unstructured text buffer starting at the given index and spanning + across the specified number of bytes using the default parser options. + + The decoded text. + The text to decode. + The starting index. + The number of bytes to decode. + + is null. + + + and do not specify + a valid range in the byte array. + + + + + Decode unstructured text. + + + Decodes the unstructured text buffer using the specified parser options. + + The decoded text. + The parser options to use. + The text to decode. + + is null. + -or- + is null. + + + + + Decode unstructured text. + + + Decodes the unstructured text buffer using the default parser options. + + The decoded text. + The text to decode. + + is null. + + + + + Encode comment text. + + + Encodes the comment text and wraps the result in parenthesis according to the rules of rfc2047 + using the specified charset encoding and formatting options. + + The encoded text. + The formatting options + The charset encoding. + The text to encode. + The starting index of the phrase to encode. + The number of characters to encode. + + is null. + -or- + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Encode a phrase. + + + Encodes the phrase according to the rules of rfc2047 using + the specified charset encoding and formatting options. + + The encoded phrase. + The formatting options + The charset encoding. + The phrase to encode. + + is null. + -or- + is null. + -or- + is null. + + + + + Encode a phrase. + + + Encodes the phrase according to the rules of rfc2047 using + the specified charset encoding and formatting options. + + The encoded phrase. + The formatting options + The charset encoding. + The phrase to encode. + The starting index of the phrase to encode. + The number of characters to encode. + + is null. + -or- + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Encode a phrase. + + + Encodes the phrase according to the rules of rfc2047 using + the specified charset encoding and formatting options. + + The encoded phrase. + The charset encoding. + The phrase to encode. + The starting index of the phrase to encode. + The number of characters to encode. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Encode a phrase. + + + Encodes the phrase according to the rules of rfc2047 using + the specified charset encoding and formatting options. + + The encoded phrase. + The formatting options + The charset encoding. + The phrase to encode. + + is null. + -or- + is null. + -or- + is null. + + + + + Encode a phrase. + + + Encodes the phrase according to the rules of rfc2047 using + the specified charset encoding. + + The encoded phrase. + The charset encoding. + The phrase to encode. + + is null. + -or- + is null. + + + + + Encode unstructured text. + + + Encodes the unstructured text according to the rules of rfc2047 + using the specified charset encoding and formatting options. + + The encoded text. + The formatting options + The charset encoding. + The text to encode. + The starting index of the phrase to encode. + The number of characters to encode. + + is null. + -or- + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Encode unstructured text. + + + Encodes the unstructured text according to the rules of rfc2047 + using the specified charset encoding and formatting options. + + The encoded text. + The charset encoding. + The text to encode. + The starting index of the phrase to encode. + The number of characters to encode. + + is null. + -or- + is null. + + + and do not specify + a valid range in the byte array. + + + + + Encode unstructured text. + + + Encodes the unstructured text according to the rules of rfc2047 + using the specified charset encoding and formatting options. + + The encoded text. + The formatting options + The charset encoding. + The text to encode. + + is null. + -or- + is null. + -or- + is null. + + + + + Encode unstructured text. + + + Encodes the unstructured text according to the rules of rfc2047 + using the specified charset encoding. + + The encoded text. + The charset encoding. + The text to encode. + + is null. + -or- + is null. + + + + + Resize the internal buffer either by doubling current buffer size or + by adding to + whichever is greater. + + + Number of chars requested beyond current position. + + + + + An optimized version of StringComparer.OrdinalIgnoreCase. + + + An optimized version of StringComparer.OrdinalIgnoreCase. + + + + + Initialize a new instance of the class. + + + Creates a new . + + + + + Compare the input strings for equality. + + + Compares the input strings for equality. + + trueif and refer to the same object, + or and are equal, + or and are null; + otherwise, false. + A string to compare to . + A string to compare to . + + + + Get the hash code for the specified string. + + + Get the hash code for the specified string. + + A 32-bit signed hash code calculated from the value of the parameter. + The string. + + is null. + + + + + An enumeration of X-Priority header values. + + + Indicates the priority of a message. + + + + + The message is of the highest priority. + + + + + The message is high priority. + + + + + The message is of normal priority. + + + + + The message is of low priority. + + + + + The message is of lowest priority. + + + + diff --git a/Bin/System.Data.SqlClient.dll b/Bin/System.Data.SqlClient.dll index 9c76bbd16..1f1b4052f 100644 Binary files a/Bin/System.Data.SqlClient.dll and b/Bin/System.Data.SqlClient.dll differ diff --git a/Bin/System.Data.SqlClient.dll.refresh b/Bin/System.Data.SqlClient.dll.refresh new file mode 100644 index 000000000..0a0688489 Binary files /dev/null and b/Bin/System.Data.SqlClient.dll.refresh differ diff --git a/Bin/System.Diagnostics.DiagnosticSource.dll b/Bin/System.Diagnostics.DiagnosticSource.dll index 8da941f2c..354f5f554 100644 Binary files a/Bin/System.Diagnostics.DiagnosticSource.dll and b/Bin/System.Diagnostics.DiagnosticSource.dll differ diff --git a/Bin/System.Diagnostics.DiagnosticSource.dll.refresh b/Bin/System.Diagnostics.DiagnosticSource.dll.refresh new file mode 100644 index 000000000..a72dce746 Binary files /dev/null and b/Bin/System.Diagnostics.DiagnosticSource.dll.refresh differ diff --git a/Bin/System.Diagnostics.DiagnosticSource.xml b/Bin/System.Diagnostics.DiagnosticSource.xml index 9edd0f184..d94e6d27f 100644 --- a/Bin/System.Diagnostics.DiagnosticSource.xml +++ b/Bin/System.Diagnostics.DiagnosticSource.xml @@ -7,6 +7,9 @@ Represents an operation with context to be used for logging. + + Occurs when the value changes. + Initializes a new instance of the class. The name of the operation. @@ -46,6 +49,21 @@ if the method is being called from the finalizer; if calling from user code. + + Enumerates the objects attached to this Activity object. + + . + + + Enumerates the objects attached to this Activity object. + + . + + + Enumerates the tags attached to this Activity object. + + . + Returns the value of a key-value pair added to the activity with . The baggage key. @@ -56,6 +74,24 @@ The name associated to the object. The object mapped to the property name, if one is found; otherwise, . + + Returns the value of the Activity tag mapped to the input key/>. + Returns if that key does not exist. + The tag key string. + The tag value mapped to the input key. + + + Add or update the Activity baggage with the input key and value. + If the input value is - if the collection has any baggage with the same key, then this baggage will get removed from the collection. + - otherwise, nothing will happen and the collection will not change. + If the input value is not - if the collection has any baggage with the same key, then the value mapped to this key will get updated with the new input value. + - otherwise, the key and value will get added as a new baggage to the collection. + Baggage item will be updated/removed only if it was originaly added to the current activity. Items inherited from the parents will not be changed/removed, new item would be added to current activity baggage instead. + The baggage key name + The baggage value mapped to the input key + + for convenient chaining. + Attaches any custom object to this activity. If the specified was previously associated with another object, the property will be updated to be associated with the new instead. It is recommended to use a unique property name to avoid conflicts with anyone using the same value. The name to associate the value with. @@ -93,6 +129,13 @@ for convenient chaining. + + Sets the status code and description on the current activity object. + The status code + The error status description + + for convenient chaining. + Adds or update the activity tag with the input key and value. The tag key name. @@ -109,19 +152,19 @@ Stops the activity. - Gets the flags (defined by the W3C ID specification) associated with the activity. + Gets or sets the flags (defined by the W3C ID specification) associated with the activity. the flags associated with the activity. Gets a collection of key/value pairs that represents information that is passed to children of this . - An enumeration of string-string key-value pairs. + Information that's passed to children of this . Gets the context of the activity. Context becomes valid only if the activity has been started. The context of the activity, if the activity has been started; otherwise, returns the default context. - Gets or sets the current operation () for the current thread. This flows across async calls. + Gets or sets the current operation () for the current thread. This flows across async calls. The current operation for the current thread. @@ -140,10 +183,13 @@ An enumeration of activity events attached to this activity. If the activity has no events, returns an empty enumeration. - Gets or sets a valud that detrmines if the is always used to define the default ID format. + Gets or sets a value that detrmines if the is always used to define the default ID format. to always use the ; otherwise, . + + Gets a value that indicates whether the parent context was created from remote propagation. + Gets an identifier that is specific to a particular request. The activity ID. @@ -153,10 +199,13 @@ The format for the . - Indicates if the this activity should be populated with all the propagation information, as well as all the other properties such as links, tags and events. + Gets or sets a value that indicates whether this activity should be populated with all the propagation information, as well as all the other properties, such as links, tags, and events. if the activity should be populated; otherwise. + + Gets a value that indicates whether this object is stopped or not. + Gets the relationship between the activity, its parents, and its children in a trace. One of the enumeration values that indicate relationship between the activity, its parents, and its children in a trace. @@ -191,7 +240,7 @@ The root ID, or if the current instance has either a or an . - Get the activity source associated with this activity. + Gets the activity source associated with this activity. Gets the SPAN part of the . @@ -201,22 +250,58 @@ Gets the time when the operation started. The UTC time that the operation started. + + Gets status code of the current activity object. + + + Gets the status description of the current activity object. + - Returns the list of tags representing information to log along with the activity. This information is not passed on to the children of this activity. + Gets the list of tags that represent information to log along with the activity. This information is not passed on to the children of this activity. A key-value pair enumeration of tags and objects. Gets a collection of key/value pairs that represent information that will be logged along with the to the logging system. - An enumeration of string-string key-value-pairs. + Information that will be logged along with the to the logging system. Gets the TraceId part of the . The ID for the TraceId part of the , if the ID has the W3C format; otherwise, a zero TraceId. + + When starting an Activity which does not have a parent context, the Trace Id will automatically be generated using random numbers. + TraceIdGenerator can be used to override the runtime's default Trace Id generation algorithm. + - Gets the W3C header. + Gets or sets the W3C header. The W3C header. + + Enumerates the data stored on an object. + Type being enumerated. + + + Returns an enumerator that iterates through the data stored on an Activity object. + + . + + + Advances the enumerator to the next element of the data. + + if the enumerator was successfully advanced to the next element; if the enumerator has passed the end of the collection. + + + Gets the element at the current position of the enumerator. + + + Provides data for the event. + + + Gets the object after the event. + + + Gets the object before the event. + A representation that conforms to the W3C TraceContext specification. It contains two identifiers: a TraceId and a SpanId, along with a set of common TraceFlags and system-specific TraceState values. @@ -265,6 +350,16 @@ The trace parent is invalid. The object created from the parsing operation. + + Tries to parse the W3C trace context headers to the object. + The W3C trace parent header. + The W3C trace state. + + to propagate the context from the remote parent; otherwise, . + When this method returns, contains the object created from the parsing operation. + + if the operation succeeds; otherwise. + Tries to parse the W3C trace context headers to an object. The W3C trace parent header. @@ -332,6 +427,9 @@ The possible generic type parameters are callbacks. The trace Id. + + Gets or initializes the trace state to use when creating the Activity. + Represents an event containing a name and a timestamp, as well as an optional list of tags. @@ -345,6 +443,11 @@ The possible generic type parameters are The event timestamp. Timestamp must only be used for the events that happened in the past, not at the moment of this call. The event tags. + + Enumerate the tags attached to this object. + + . + Gets the activity event name. A string representing the activity event name. @@ -399,6 +502,11 @@ Activity links can be used to represent batched operations where an activity was The trace activity context. The key-value pair list of tags associated to the activity context. + + Enumerate the tags attached to this object. + + . + Indicates whether the current activity link is equal to another activity link. The activity link to compare. @@ -493,6 +601,33 @@ Activity links can be used to represent batched operations where an activity was Adds a listener to the activity starting and stopping events. The activity listener object to use for listening to the activity events. + + Creates a new object if there is any listener to the Activity, returns otherwise. + The operation name of the Activity + The + The created object or if there is no any event listener. + + + Creates a new object if there is any listener to the Activity, returns otherwise. + If the Activity object is created, it will not automatically start. Callers will need to call to start it. + The operation name of the Activity. + The + The parent object to initialize the created Activity object with. + The optional tags list to initialize the created Activity object with. + The optional list to initialize the created Activity object with. + The default Id format to use. + The created object or if there is no any listener. + + + Creates a new object if there is any listener to the Activity, returns otherwise. + The operation name of the Activity. + The + The parent Id to initialize the created Activity object with. + The optional tags list to initialize the created Activity object with. + The optional list to initialize the created Activity object with. + The default Id format to use. + The created object or if there is no any listener. + Disposes the activity source object, removes the current instance from the global list, and empties the listeners list. @@ -501,6 +636,16 @@ Activity links can be used to represent batched operations where an activity was if there is a listener registered for this activity source; otherwise, . + + Creates and starts a new object if there is any listener to the Activity events, returns otherwise. + The + The parent object to initialize the created Activity object with. + The optional tags list to initialize the created Activity object with. + The optional list to initialize the created Activity object with. + The optional start timestamp to set on the created Activity object. + The operation name of the Activity. + The created object or if there is no any listener. + Creates a new activity if there are active listeners for it, using the specified name and activity kind. The operation name of the activity. @@ -607,6 +752,18 @@ The characters in are not all lower-case hexadecimal Returns a 16-character hexadecimal string that represents this span ID. The 16-character hexadecimal string representation of this span ID. + + Define the status code of the Activity which indicate the status of the instrumented operation. + + + Status code indicating an error is encountered during the operation. + + + Status code indicating the operation has been validated and completed successfully. + + + Unset status code is the default value indicating the status code is not initialized. + ActivityTagsCollection is a collection class used to store tracing tags. @@ -629,7 +786,7 @@ This collection behaves as follows: Initial list to store in the collection. - Adds an item to the collection + Adds an item to the collection. Key and value pair of the tag to add to the collection. already exists in the list. @@ -693,6 +850,7 @@ This collection behaves as follows: Gets the number of elements contained in the collection. + The number of elements contained in the . Gets a value indicating whether the collection is read-only. This always returns . @@ -710,9 +868,11 @@ This collection behaves as follows: Get the list of the keys of all stored tags. + An containing the keys of the object that implements . Get the list of the values of all stored tags. + An containing the values in the object that implements . Enumerates the elements of an . @@ -776,8 +936,8 @@ The characters in are not all lower-case hexadecimal The new trace ID. - Creates a new based on a random number (that is very likely to be unique). - The new span ID. + Creates a new based on a random number (that is very likely to be unique). + The new . Determines whether the current instance and a specified are equal. @@ -810,7 +970,7 @@ The characters in are not all lower-case hexadecimal if the TraceId of is different from the TraceId of ; otherwise, . - Returns a 16-character hexadecimal string that represents this span ID. + Returns a 32-character hexadecimal string that represents this span ID. The 32-character hexadecimal string representation of this trace ID. @@ -933,21 +1093,794 @@ The characters in are not all lower-case hexadecimal An object that represent the value being passed as a payload for the event. The started activity for convenient chaining. + + + + + Stops the given , maintains the global activity, and notifies consumers that the was stopped. The activity to be stopped. An object that represents the value passed as a payload for the event. + + + + + Provides a generic way of logging complex payloads. The name of the event being written. An object that represents the value being passed as a payload for the event. This is often an anonymous type which contains several sub-values. + + + + + + + An implementation of determines if and how distributed context information is encoded and decoded as it traverses the network. + The encoding can be transported over any network protocol that supports string key-value pairs. For example, when using HTTP, each key-value pair is an HTTP header. + injects values into and extracts values from carriers as string key-value pairs. + + + Initializes an instance of the class. This constructor is protected and only meant to be called from parent classes. + + + Returns the default propagator object that will be initialized with. + An instance of the class. + + + Returns a propagator that does not transmit any distributed context information in outbound network messages. + An instance of the class. + + + Returns a propagator that attempts to act transparently, emitting the same data on outbound network requests that was received on the inbound request. + When encoding the outbound message, this propagator uses information from the request's root Activity, ignoring any intermediate Activities that may have been created while processing the request. + An instance of the class. + + + Extracts the baggage key-value pair list from an incoming request represented by the carrier. For example, from the headers of an HTTP request. + The medium from which values will be read. + The callback method to invoke to get the propagation baggage list from the carrier. + Returns the extracted key-value pair list from the carrier. + + + Extracts the trace ID and trace state from an incoming request represented by the carrier. For example, from the headers of an HTTP request. + The medium from which values will be read. + The callback method to invoke to get the propagation trace ID and state from the carrier. + When this method returns, contains the trace ID extracted from the carrier. + When this method returns, contains the trace state extracted from the carrier. + + + Injects the trace values stored in the object into a carrier. For example, into the headers of an HTTP request. + The Activity object has the distributed context to inject to the carrier. + The medium in which the distributed context will be stored. + The callback method to invoke to set a named key-value pair on the carrier. + + + Get or set the process-wide propagator object to use as the current selected propagator. + The currently selected process-wide propagator object. + + + Gets the set of field names this propagator is likely to read or write. + The list of fields that will be used by the DistributedContextPropagator. + + + Represents the callback method that's used in the extract methods of propagators. The callback is invoked to look up the value of a named field. + The medium used by propagators to read values from. + The propagation field name. + When this method returns, contains the value that corresponds to . The value is non- if there is only one value for the input field name. + When this method returns, contains a collection of values that correspond to . The value is non- if there is more than one value for the input field name. + + + Represents the callback method that's used in propagators' inject methods. This callback is invoked to set the value of a named field. + Propagators may invoke it multiple times in order to set multiple fields. + The medium used by propagators to write values to. + The propagation field name. + The value corresponding to . + + + Represents an instrument that supports adding non-negative values. For example, you might call counter.Add(1) each time a request is processed to track the total number of requests. Most metric viewers display counters using a rate (requests/sec), by default, but can also display a cumulative total. + The type that the counter represents. + + + Records the increment value of the measurement. + The increment measurement. + + + Records the increment value of the measurement. + The increment measurement. + A key-value pair tag associated with the measurement. + + + Records the increment value of the measurement. + The increment measurement. + A first key-value pair tag associated with the measurement. + A second key-value pair tag associated with the measurement. + + + Records the increment value of the measurement. + The increment measurement. + A first key-value pair tag associated with the measurement. + A second key-value pair tag associated with the measurement. + A third key-value pair tag associated with the measurement. + + + Records the increment value of the measurement. + The increment measurement. + A list of key-value pair tags associated with the measurement. + + + Adds the increment value of the measurement. + The measurement value. + The tags associated with the measurement. + + + Records the increment value of the measurement. + The increment measurement. + A span of key-value pair tags associated with the measurement. + + + Represents a metrics instrument that can be used to report arbitrary values that are likely to be statistically meaningful, for example, the request duration. Call to create a Histogram object. + The type that the histogram represents. + + + Records a measurement value. + The measurement value. + + + Records a measurement value. + The measurement value. + A key-value pair tag associated with the measurement. + + + Records a measurement value. + The measurement value. + A first key-value pair tag associated with the measurement. + A second key-value pair tag associated with the measurement. + + + Records a measurement value. + The measurement value. + A first key-value pair tag associated with the measurement. + A second key-value pair tag associated with the measurement. + A third key-value pair tag associated with the measurement. + + + Records a measurement value. + The measurement value. + A list of key-value pair tags associated with the measurement. + + + Records a measurement value. + The measurement value. + The tags associated with the measurement. + + + Records a measurement value. + The measurement value. + A span of key-value pair tags associated with the measurement. + + + + + + + Base class of all metrics instrument classes + + + Protected constructor to initialize the common instrument properties like the meter, name, description, and unit. + The meter that created the instrument. + The instrument name. Cannot be . + Optional instrument unit of measurements. + Optional instrument description. + + + + + + + + + + Activates the instrument to start recording measurements and to allow listeners to start listening to such measurements. + + + Gets the instrument description. + + + Gets a value that indicates if there are any listeners for this instrument. + + + Gets a value that indicates whether the instrument is an observable instrument. + + + Gets the Meter that created the instrument. + + + Gets the instrument name. + + + + Gets the instrument unit of measurements. + + + The base class for all non-observable instruments. + The type that the instrument represents. + + + Create the metrics instrument using the properties meter, name, description, and unit. + The meter that created the instrument. + The instrument name. Cannot be . + Optional instrument unit of measurements. + Optional instrument description. + + + + + + + + + + Records a measurement by notifying all objects that are listening to this instrument. + The measurement value. + + + Records a measurement by notifying all objects that are listening to this instrument. + The measurement value. + A key-value pair tag associated with the measurement. + + + Records a measurement by notifying all objects that are listening to this instrument. + The measurement value. + A first key-value pair tag associated with the measurement. + A second key-value pair tag associated with the measurement. + + + Records a measurement by notifying all objects that are listening to this instrument. + The measurement value. + A first key-value pair tag associated with the measurement. + A second key-value pair tag associated with the measurement. + A third key-value pair tag associated with the measurement. + + + Records a measurement by notifying all objects that are listening to this instrument. + The measurement value. + The tags associated with the measurement. + + + Records a measurement by notifying all objects that are listening to this instrument. + The measurement value. + A span of key-value pair tags associated with the measurement. + + + Stores one observed metrics value and its associated tags. This type is used by an Observable instrument's Observe() method when reporting current measurements. + The type that the measurement represents. + + + Initializes a new instance of using the specified value. + The measurement value. + + + Initializes a new instance of using the specified value and list of tags. + The measurement value. + The list of tags associated with the measurement. + + + Initializes a new instance of using the specified value and list of tags. + The measurement value. + The list of tags associated with the measurement. + + + Initializes a new instance of using the specified value and list of tags. + The measurement value. + The list of tags associated with the measurement. + + + Gets the measurement tags list. + + + Gets the measurement value. + + + A delegate to represent the Meterlistener callbacks that are used when recording measurements. + The instrument that sent the measurement. + The measurement value. + A span of key-value pair tags associated with the measurement. + The state object originally passed to method. + The type that the measurement represents. + + + Meter is the class responsible for creating and tracking the Instruments. + + + + + + Initializes a new instance of using the specified meter name. + The Meter name. + + + Initializes a new instance of using the specified meter name and version. + The Meter name. + The optional Meter version. + + + + + + + + + Create a metrics Counter object. + The instrument name. Cannot be . + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement. + A new counter. + + + + + + + + + + Creates a Histogram, which is an instrument that can be used to report arbitrary values that are likely to be statistically meaningful. It is intended for statistics such as histograms, summaries, and percentiles. + The instrument name. Cannot be . + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement. + A new histogram. + + + + + + + + + + Creates an ObservableCounter, which is an instrument that reports monotonically increasing values when the instrument is being observed. + The instrument name. Cannot be . + The callback to call to get the measurements when ObservableCounter{T}.Observe() is called by . + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement.. + A new observable counter. + + + + + + + + + + + Creates an ObservableCounter, which is an instrument that reports monotonically increasing values when the instrument is being observed. + The instrument name. Cannot be . + The callback to call to get the measurements when ObservableCounter{T}.Observe() is called by . + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement. + A new observable counter. + + + + + + + + + + + Creates an ObservableCounter, which is an instrument that reports monotonically increasing values when the instrument is being observed. + The instrument name. Cannot be . + The callback to call to get the measurements when ObservableCounter{T}.Observe() is called by + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement. + A new observable counter. + + + + + + + + + + + Creates an ObservableGauge, which is an asynchronous instrument that reports non-additive values when the instrument is being observed. + The instrument name. Cannot be . + The callback to call to get the measurements when ObservableCounter{T}.Observe() is called by . + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement. + A new observable gauge. + + + + + + + + + + + Creates an ObservableGauge, which is an asynchronous instrument that reports non-additive values when the instrument is being observed. + The instrument name. Cannot be . + The callback to call to get the measurements when ObservableCounter{T}.Observe() is called by . + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement. + A new observable gauge. + + + + + + + + + + + Creates an ObservableGauge, which is an asynchronous instrument that reports non-additive values when the instrument is being observed. + The instrument name. Cannot be . + The callback to call to get the measurements when ObservableCounter{T}.Observe() is called by . + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement. + A new observable gauge. + + + + + + + + + + + Creates an ObservableUpDownCounter object. ObservableUpDownCounter is an Instrument that reports increasing or decreasing values when the instrument is being observed. + The instrument name. Cannot be . + The callback to call to get the measurements when the is called by . + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement. + A new observable up down counter. + + + + + + + + + + + Creates an ObservableUpDownCounter object. ObservableUpDownCounter is an Instrument that reports increasing or decreasing values when the instrument is being observed. + The instrument name. Cannot be . + The callback to call to get the measurements when the is called by . + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement. + A new observable up down counter. + + + + + + + + + + + Creates an ObservableUpDownCounter object. ObservableUpDownCounter is an Instrument that reports increasing or decreasing values when the instrument is being observed. + The instrument name. Cannot be . + The callback to call to get the measurements when the is called by + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement. + A new observable up down counter. + + + + + + + + + + + Create a metrics UpDownCounter object. + The instrument name. Cannot be . + Optional instrument unit of measurements. + Optional instrument description. + The numerical type of the measurement. + A new up down counter. + + + + + + + + + + Dispose the Meter which will disable all instruments created by this meter. + + + + + + Gets the Meter name. + The Meter name + + + + + Gets the Meter version. + The Meter version. + + + + + + + + + + The MeterListener is class used to listen to the metrics instrument measurements recording. + + + Initializes a new instance of the class. + + + Stops listening to a specific instrument measurement recording. + The instrument to stop listening to. + The state object originally passed to method. + + + Disposes the listeners which will stop it from listening to any instrument. + + + Starts listening to a specific instrument measurement recording. + The instrument to listen to. + A state object that will be passed back to the callback getting measurements events. + + + Calls all Observable instruments that the listener is listening to, and calls with every collected measurement. + + + Sets a callback for a specific numeric type to get the measurement recording notification from all instruments which enabled listening and was created with the same specified numeric type. + If a measurement of type T is recorded and a callback of type T is registered, that callback will be used. + The callback which can be used to get measurement recording of numeric type T. + The type of the numeric measurement. + + + Enables the listener to start listening to instruments measurement recording. + + + Gets or sets the callback to get notified when an instrument is published. + The callback to get notified when an instrument is published. + + + Gets or sets the callback to get notified when the measurement is stopped on some instrument. + This can happen when the Meter or the Listener is disposed or calling on the listener. + The callback to get notified when the measurement is stopped on some instrument. + + + + + + + + + + + Represents a metrics-observable instrument that reports monotonically increasing values when the instrument is being observed, for example, CPU time (for different processes, threads, user mode, or kernel mode). Call to create the observable counter object. + The type that the observable counter represents. + + + Represents an observable instrument that reports non-additive values when the instrument is being observed, for example, the current room temperature. Call to create the observable counter object. + + + + ObservableInstrument{T} is the base class from which all metrics observable instruments will inherit. + The type that the observable instrument represents. + + + Initializes a new instance of the class using the specified meter, name, description, and unit. + All classes that extend ObservableInstrument{T} must call this constructor when constructing objects of the extended class. + The meter that created the instrument. + The instrument name. cannot be . + Optional instrument unit of measurements. + Optional instrument description. + + + + + + + + + + Fetches the current measurements being tracked by this instrument. All classes extending ObservableInstrument{T} need to implement this method. + The current measurements tracked by this instrument. + + + Gets a value that indicates if the instrument is an observable instrument. + + if the instrument is metrics-observable; otherwise. + + + A metrics-observable instrument that reports increasing or decreasing values when the instrument is being observed. +Use this instrument to monitor the process heap size or the approximate number of items in a lock-free circular buffer, for example. +To create an ObservableUpDownCounter object, use the methods. + The type that the counter represents. + + + An instrument that supports reporting positive or negative metric values. + UpDownCounter may be used in scenarios like reporting the change in active requests or queue size. + The type that the UpDownCounter represents. + + + Records the delta value of the measurement. The delta can be positive, negative, or zero. + The amount to be added, which can be positive, negative, or zero. + + + Records the delta value of the measurement. The delta can be positive, negative, or zero. + The amount to be added, which can be positive, negative, or zero. + A key-value pair tag associated with the measurement. + + + Records the delta value of the measurement. The delta can be positive, negative, or zero. + The amount to be added, which can be positive, negative, or zero. + A first key-value pair tag associated with the measurement. + A second key-value pair tag associated with the measurement. + + + Records the delta value of the measurement. The delta can be positive, negative, or zero. + The amount to be added, which can be positive, negative, or zero. + A first key-value pair tag associated with the measurement. + A second key-value pair tag associated with the measurement. + A third key-value pair tag associated with the measurement. + + + Records the delta value of the measurement. The delta can be positive, negative, or zero. + The amount to be added, which can be positive, negative, or zero. + A list of key-value pair tags associated with the measurement. + + + Records the delta value of the measurement. The delta can be positive, negative, or zero. + The amount to be added, which can be positive, negative, or zero. + A of tags associated with the measurement. + + + Records the delta value of the measurement. The delta can be positive, negative, or zero. + The amount to be added, which can be positive, negative, or zero. + A span of key-value pair tags associated with the measurement. + A delegate that defines the signature of the callbacks used in the sampling process. The Activity creation options used by callbacks to decide creating the Activity object or not. The type of the requested parent to create the Activity object with. Should be either a string or an instance. An object containing the sampling results, which indicate the amount of data to collect for the related . + + Represents a list of tags that can be accessed by index. Provides methods to search, sort, and manipulate lists. + + + Initializes a new instance of using the specified . + A span of tags to initialize the list with. + + + Adds a tag to the list. + The key-value pair of the tag to add to the list. + + + Adds a tag with the specified and to the list. + The tag key. + The tag value. + + + Removes all elements from the . + + + Determines whether a tag is in the . + The tag to locate in the . + + if item is found in the ; otherwise, . + + + Copies the entire 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 Array must have zero-based indexing. + The zero-based index in at which copying begins. + + is . + + is less than 0 or greater than or equal to the length. + + + Copies the contents of this into a destination span. + The destination object. + + The number of elements in the source is greater than the number of elements that the destination span. + + + Returns an enumerator that iterates through the . + An enumerator that iterates through the . + + + Searches for the specified tag and returns the zero-based index of the first occurrence within the entire . + The tag to locate in the . + The zero-based index of the first ocurrence of in the tag list. + + + Inserts an element into the at the specified index. + The zero-based index at which the item should be inserted. + The tag to insert. + + is less than 0 or is greater than . + + + Removes the first occurrence of a specific object from the . + The tag to remove from the . + + if is successfully removed; otherwise, . This method also returns if was not found in the . + + + Removes the element at the specified index of the . + The zero-based index of the element to remove. + + index is less than 0 or is greater than . + + + Returns an enumerator that iterates through the . + An enumerator that iterates through the . + + + Gets the number of tags contained in the . + The number of elements contained in the . + + + Gets a value indicating whether the is read-only. This property will always return . + + Always returns . + + + Gets or sets the tags at the specified index. + The item index. + + is not a valid index in the . + The element at the specified index. + + + An enumerator for traversing a tag list collection. + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + Advances the enumerator to the next element of the collection. + + if the enumerator was successfully advanced to the next element; 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. + + + Gets the element in the collection at the current position of the enumerator. + The element in the collection at the current position of the enumerator. + + + Gets the element in the collection at the current position of the enumerator. + The element in the collection at the current position of the enumerator. + \ No newline at end of file diff --git a/Bin/System.Formats.Asn1.dll b/Bin/System.Formats.Asn1.dll new file mode 100644 index 000000000..bc6041aec Binary files /dev/null and b/Bin/System.Formats.Asn1.dll differ diff --git a/Bin/System.Runtime.CompilerServices.Unsafe.dll b/Bin/System.Runtime.CompilerServices.Unsafe.dll index 1908d925a..c5ba4e404 100644 Binary files a/Bin/System.Runtime.CompilerServices.Unsafe.dll and b/Bin/System.Runtime.CompilerServices.Unsafe.dll differ diff --git a/Bin/System.Runtime.CompilerServices.Unsafe.xml b/Bin/System.Runtime.CompilerServices.Unsafe.xml index b5dd21bfb..9d794922c 100644 --- a/Bin/System.Runtime.CompilerServices.Unsafe.xml +++ b/Bin/System.Runtime.CompilerServices.Unsafe.xml @@ -21,6 +21,13 @@ The type of reference. A new reference that reflects the addition of offset to pointer. + + Adds an element offset to the given reference. + The reference to add the offset to. + The offset to add. + The type of reference. + A new reference that reflects the addition of offset to pointer. + Adds an element offset to the given void pointer. The void pointer to add the offset to. @@ -35,6 +42,13 @@ The type of reference. A new reference that reflects the addition of byte offset to pointer. + + Adds a byte offset to the given reference. + The reference to add the offset to. + The offset to add. + The type of reference. + A new reference that reflects the addition of byte offset to pointer. + Determines whether the specified references point to the same location. The first reference to compare. @@ -158,11 +172,16 @@ if is less than ; otherwise, . - - + Determines if a given reference to a value of type is a null reference. + The reference to check. + The type of the reference. + + if is a null reference; otherwise, . - + Returns a reference to a value of type that is a null reference. + The type of the reference. + A reference to a value of type that is a null reference. Reads a value of type from the given location. @@ -206,6 +225,13 @@ The type of reference. A new reference that reflects the subtraction of offset from pointer. + + Subtracts an element offset from the given reference. + The reference to subtract the offset from. + The offset to subtract. + The type of reference. + A new reference that reflects the subraction of offset from pointer. + Subtracts an element offset from the given void pointer. The void pointer to subtract the offset from. @@ -220,6 +246,13 @@ The type of reference. A new reference that reflects the subtraction of byte offset from pointer. + + Subtracts a byte offset from the given reference. + The reference to subtract the offset from. + The offset to subtract. + The type of reference. + A new reference that reflects the subraction of byte offset from pointer. + Returns a to a boxed value. The value to unbox. diff --git a/Bin/System.Text.Encodings.Web.dll b/Bin/System.Text.Encodings.Web.dll index 8599b3949..3d16c7e9d 100644 Binary files a/Bin/System.Text.Encodings.Web.dll and b/Bin/System.Text.Encodings.Web.dll differ diff --git a/Bin/System.Text.Encodings.Web.dll.refresh b/Bin/System.Text.Encodings.Web.dll.refresh new file mode 100644 index 000000000..179d70357 Binary files /dev/null and b/Bin/System.Text.Encodings.Web.dll.refresh differ diff --git a/Bin/System.Text.Encodings.Web.xml b/Bin/System.Text.Encodings.Web.xml index 6659e6f32..ecf797950 100644 --- a/Bin/System.Text.Encodings.Web.xml +++ b/Bin/System.Text.Encodings.Web.xml @@ -307,6 +307,9 @@ Gets the Arabic Extended-A Unicode block (U+08A0-U+08FF). The Arabic Extended-A Unicode block (U+08A0-U+08FF). + + A corresponding to the 'Arabic Extended-B' Unicode block (U+0870..U+089F). + Gets the Arabic Presentation Forms-A Unicode block (U+FB50-U+FDFF). The Arabic Presentation Forms-A Unicode block (U+FB50-U+FDFF). diff --git a/Bin/System.Text.Json.dll b/Bin/System.Text.Json.dll index 8c53363a8..81822f394 100644 Binary files a/Bin/System.Text.Json.dll and b/Bin/System.Text.Json.dll differ diff --git a/Bin/System.Text.Json.dll.refresh b/Bin/System.Text.Json.dll.refresh new file mode 100644 index 000000000..917467635 Binary files /dev/null and b/Bin/System.Text.Json.dll.refresh differ diff --git a/Bin/System.Text.Json.xml b/Bin/System.Text.Json.xml index e9d8f260c..da1a57123 100644 --- a/Bin/System.Text.Json.xml +++ b/Bin/System.Text.Json.xml @@ -20,10 +20,10 @@ Provides a mechanism for examining the structural content of a JSON value without automatically instantiating data values. - Releases the resources used by this instance. + Releases the resources used by this instance. - Parses a sequence as UTF-8-encoded text representing a single JSON byte value into a JsonDocument. + Parses a sequence as UTF-8-encoded text representing a single JSON value into a JsonDocument. The JSON text to parse. Options to control the reader behavior during parsing. @@ -43,7 +43,7 @@ A JsonDocument representation of the JSON value. - Parses memory as UTF-8-encoded text representing a single JSON byte value into a JsonDocument. + Parses memory as UTF-8-encoded text representing a single JSON value into a JsonDocument. The JSON text to parse. Options to control the reader behavior during parsing. @@ -53,7 +53,7 @@ A JsonDocument representation of the JSON value. - Parses text representing a single JSON character value into a JsonDocument. + Parses text representing a single JSON value into a JsonDocument. The JSON text to parse. Options to control the reader behavior during parsing. @@ -311,6 +311,15 @@ The current token does not start or represent a value The parent has been disposed. The current JSON number as a . + + Parses one JSON value (including objects or arrays) from the provided reader. + The reader to read. + + is using unsupported options. + The current token does not start or represent a value. + A value could not be read from the reader. + A JsonElement representing the value (and nested values) read from the reader. + Gets a string representation for the current value appropriate to the value type. The parent has been disposed. @@ -318,7 +327,7 @@ The current token does not start or represent a value Attempts to represent the current JSON number as a . - When the method returns, contains the byte equivalent of the current JSON number if the conversion succeeded. + When this method returns, contains the byte equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. This value's is not . The parent has been disposed. @@ -334,7 +343,7 @@ The current token does not start or represent a value Attempts to represent the current JSON string as a . - When this method returns, contains the date and time value equivalent to the current JSON string. + When this method returns, contains the date and time value equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. This value's is not . The parent has been disposed. @@ -342,7 +351,7 @@ The current token does not start or represent a value Attempts to represent the current JSON string as a . - When this method returns, contains the date and time equivalent to the current JSON string. + When this method returns, contains the date and time value equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. This value's is not . The parent has been disposed. @@ -350,7 +359,7 @@ The current token does not start or represent a value Attempts to represent the current JSON number as a . - When this method returns, contains the decimal equivalent of the current JSON number. + When this method returns, contains the decimal equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. This value's is not . The parent has been disposed. @@ -358,7 +367,7 @@ The current token does not start or represent a value Attempts to represent the current JSON number as a . - When this method returns, contains a double-precision floating point value equivalent to the current JSON number. + When this method returns, contains a double-precision floating point value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. This value's is not . The parent has been disposed. @@ -366,7 +375,7 @@ The current token does not start or represent a value Attempts to represent the current JSON string as a . - When this method returns, contains the GUID equivalent to the current JSON string. + When this method returns, contains the GUID equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. This value's is not . The parent has been disposed. @@ -374,7 +383,7 @@ The current token does not start or represent a value Attempts to represent the current JSON number as an . - When the method returns, contains the 16-bit integer equivalent of the current JSON number if the conversion succeeded. + When this method returns, contains the 16-bit integer value equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. This value's is not . The parent has been disposed. @@ -382,7 +391,7 @@ The current token does not start or represent a value Attempts to represent the current JSON number as an . - When this method returns, contains the 32-biut integer value equivalent to the current JSON number. + When this method returns, contains the 32-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. This value's is not . The parent has been disposed. @@ -390,7 +399,7 @@ The current token does not start or represent a value Attempts to represent the current JSON number as a . - When this method returns, contains the 64-bit integer value equivalent to the current JSON number. + When this method returns, contains the 64-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. This value's is not . The parent has been disposed. @@ -427,7 +436,7 @@ The current token does not start or represent a value Attempts to represent the current JSON number as an . - When the method returns, contains the signed byte equivalent of the current JSON number if the conversion succeeded. + When this method returns, contains the signed byte equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. This value's is not . The parent has been disposed. @@ -435,7 +444,7 @@ The current token does not start or represent a value Attempts to represent the current JSON number as a . - When this method returns, contains the single-precision floating point value equivalent to the current JSON number. + When this method returns, contains the single-precision floating point value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. This value's is not . The parent has been disposed. @@ -443,7 +452,7 @@ The current token does not start or represent a value Attempts to represent the current JSON number as a . - When the method returns, contains the unsigned 16-bit integer equivalent of the current JSON number if the conversion succeeded. + When this method returns, contains the unsigned 16-bit integer value equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. This value's is not . The parent has been disposed. @@ -451,7 +460,7 @@ The current token does not start or represent a value Attempts to represent the current JSON number as a . - When this method returns, contains unsigned 32-bit integer value equivalent to the current JSON number. + When this method returns, contains unsigned 32-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. This value's is not . The parent has been disposed. @@ -459,12 +468,24 @@ The current token does not start or represent a value Attempts to represent the current JSON number as a . - When this method returns, contains unsigned 64-bit integer value equivalent to the current JSON number. + When this method returns, contains unsigned 64-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. This value's is not . The parent has been disposed. if the number can be represented as a ; otherwise, . + + Attempts to parse one JSON value (including objects or arrays) from the provided reader. + The reader to read. + Receives the parsed element. + + is using unsupported options. + The current token does not start or represent a value. + A value could not be read from the reader. + + if a value was read and parsed into a JsonElement; if the reader ran out of data while parsing. + All other situations result in an exception being thrown. + Compares the text represented by a UTF8-encoded byte span to the string value of this element. The UTF-8 encoded text to compare against. @@ -512,7 +533,7 @@ The current token does not start or represent a value Represents an enumerator for the contents of a JSON array. - Releases the resources used by this instance. + Releases the resources used by this instance. Returns an enumerator that iterates through a collection. @@ -521,14 +542,14 @@ The current token does not start or represent a value Advances the enumerator to the next element of the collection. - if the enumerator was successfully advanced to the next element; if the enumerator has passed the end 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. - + Returns an enumerator that iterates through a collection. - An enumerator for an array of that can be used to iterate through the collection. + An enumerator for an array of that can be used to iterate through the collection. Returns an enumerator that iterates through a collection. @@ -546,7 +567,7 @@ The current token does not start or represent a value Represents an enumerator for the properties of a JSON object. - Releases the resources used by this instance. + Releases the resources used by this instance. Returns an enumerator that iterates the properties of an object. @@ -555,14 +576,14 @@ The current token does not start or represent a value Advances the enumerator to the next element of the collection. - if the enumerator was successfully advanced to the next element; if the enumerator has passed the end 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. - + Returns an enumerator that iterates through a collection. - An enumerator for objects that can be used to iterate through the collection. + An enumerator for objects that can be used to iterate through the collection. Returns an enumerator that iterates through a collection. @@ -641,8 +662,11 @@ The current token does not start or represent a value Gets the UTF-8 encoded representation of the pre-encoded JSON text. The UTF-8 encoded representation of the pre-encoded JSON text. + + Gets the UTF-16 encoded representation of the pre-encoded JSON text as a . + - Defines a custom exception object that is thrown when invalid JSON text is encountered, when the defined maximum depth is passed, or the JSON text is not compatible with the type of a property on an object. + Defines a custom exception object that is thrown when invalid JSON text is encountered, the defined maximum depth is passed, or the JSON text is not compatible with the type of a property on an object. Initializes a new instance of the class. @@ -714,6 +738,18 @@ The current token does not start or represent a value Gets the naming policy for camel-casing. The naming policy for camel-casing. + + Gets the naming policy for lowercase kebab-casing. + + + Gets the naming policy for uppercase kebab-casing. + + + Gets the naming policy for lowercase snake-casing. + + + Gets the naming policy for uppercase snake-casing. + Represents a single property for a JSON object. @@ -793,6 +829,50 @@ The current token does not start or represent a value Provides functionality to serialize objects or value types to JSON and to deserialize JSON into objects or value types. + + Reads the UTF-8 encoded text representing a single JSON value into an instance specified by the . + The Stream will be read to completion. + JSON data to parse. + Metadata about the type to convert. + + or is . + The JSON is invalid, + or there is remaining data in the Stream. + A representation of the JSON value. + + + Reads the UTF-8 encoded text representing a single JSON value into a . + The Stream will be read to completion. + JSON data to parse. + The type of the object to convert to and return. + Options to control the behavior during reading. + + or is . + The JSON is invalid, the is not compatible with the JSON, or there is remaining data in the Stream. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Reads the UTF-8 encoded text representing a single JSON value into a . + The Stream will be read to completion. + JSON data to parse. + The type of the object to convert to and return. + A metadata provider for serializable types. + + , , or is . + The JSON is invalid, the is not compatible with the JSON, or there is remaining data in the Stream. + There is no compatible for or its serializable members. + The method on the provided did not return a compatible for . + A representation of the JSON value. + + + Parses the UTF-8 encoded text representing a single JSON value into an instance specified by the . + JSON text to parse. + Metadata about the type to convert. + The JSON is invalid, + or there is remaining data in the buffer. + A representation of the JSON value. + Parses the UTF-8 encoded text representing a single JSON value into an instance of a specified type. The JSON text to parse. @@ -812,6 +892,91 @@ There is remaining data in the span beyond a single JSON value. There is no compatible for or its serializable members. A representation of the JSON value. + + Parses the UTF-8 encoded text representing a single JSON value into a . + JSON text to parse. + The type of the object to convert to and return. + A metadata provider for serializable types. + + is . + The JSON is invalid, is not compatible with the JSON, or there is remaining data in the Stream. + There is no compatible for or its serializable members. + The method on the provided did not return a compatible for . + A representation of the JSON value. + + + Parses the text representing a single JSON value into an instance specified by the . + JSON text to parse. + Metadata about the type to convert. + + is . + The JSON is invalid. + +-or- + +There is remaining data in the string beyond a single JSON value. + A representation of the JSON value. + + + Parses the text representing a single JSON value into an instance of a specified type. + The JSON text to parse. + The type of the object to convert to and return. + Options to control the behavior during parsing. + + is . + The JSON is invalid. + +-or- + + is not compatible with the JSON. + +-or- + +There is remaining data in the span beyond a single JSON value. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Parses the text representing a single JSON value into a . + JSON text to parse. + The type of the object to convert to and return. + A metadata provider for serializable types. + + or is . + +-or- + + is . + The JSON is invalid. + +-or- + + is not compatible with the JSON. + +-or- + +There is remaining data in the string beyond a single JSON value. + There is no compatible for or its serializable members. + The method of the provided returns for the type to convert. + A representation of the JSON value. + + + Parses the text representing a single JSON value into an instance specified by the . + JSON text to parse. + Metadata about the type to convert. + + is . + +-or- + + is . + The JSON is invalid. + +-or- + +There is remaining data in the string beyond a single JSON value. + A representation of the JSON value. + Parses the text representing a single JSON value into an instance of a specified type. The JSON text to parse. @@ -820,7 +985,7 @@ There is remaining data in the span beyond a single JSON value. or is . The JSON is invalid. - + -or- is not compatible with the JSON. @@ -831,6 +996,179 @@ There is remaining data in the string beyond a single JSON value. There is no compatible for or its serializable members. A representation of the JSON value. + + Parses the text representing a single JSON value into a . + JSON text to parse. + The type of the object to convert to and return. + A metadata provider for serializable types. + + or is . + +-or- + + is . + The JSON is invalid. + +-or- + + is not compatible with the JSON. + +-or- + +There is remaining data in the string beyond a single JSON value. + There is no compatible for or its serializable members. + The method of the provided returns for the type to convert. + A representation of the JSON value. + + + Converts the representing a single JSON value into an instance specified by the . + The to convert. + Metadata about the type to convert. + + is . + +-or- + + is . + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + The type of the object to convert to and return. + Options to control the behavior during parsing. + + or is . + + is not compatible with the JSON. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + The type of the object to convert to and return. + A metadata provider for serializable types. + + is . + +-or- + + is . + +-or- + + is . + The JSON is invalid. + +-or- + + is not compatible with the JSON. + +-or- + +There is remaining data in the string beyond a single JSON value. + There is no compatible for or its serializable members. + The method of the provided returns for the type to convert. + A representation of the JSON value. + + + Converts the representing a single JSON value into an instance specified by the . + The to convert. + Metadata about the type to convert. + + is . + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + The type of the object to convert to and return. + Options to control the behavior during parsing. + + is . + + is not compatible with the JSON. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + The type of the object to convert to and return. + A metadata provider for serializable types. + + is . + +-or- + + is . + The JSON is invalid. + +-or- + + is not compatible with the JSON. + +-or- + +There is remaining data in the string beyond a single JSON value. + There is no compatible for or its serializable members. + The method of the provided returns for the type to convert. + A representation of the JSON value. + + + Converts the representing a single JSON value into an instance specified by the . + The to convert. + Metadata about the type to convert. + + is . + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + The type of the object to convert to and return. + Options to control the behavior during parsing. + + is not compatible with the JSON. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + The type of the object to convert to and return. + A metadata provider for serializable types. + + is . + +-or- + + is . + The JSON is invalid. + +-or- + + is not compatible with the JSON. + +-or- + +There is remaining data in the string beyond a single JSON value. + There is no compatible for or its serializable members. + The method of the provided returns for the type to convert. + A representation of the JSON value. + + + Reads one JSON value (including objects or arrays) from the provided reader into an instance specified by the . + The reader to read. + Metadata about the type to convert. + The JSON is invalid, + is not compatible with the JSON, + or a value could not be read from the reader. + + is using unsupported options. + A representation of the JSON value. + Reads one JSON value (including objects or arrays) from the provided reader and converts it into an instance of a specified type. The reader to read the JSON from. @@ -839,7 +1177,7 @@ There is remaining data in the string beyond a single JSON value. is . The JSON is invalid. - + -or- is not compatible with the JSON. @@ -852,6 +1190,44 @@ A value could not be read from the reader. There is no compatible for or its serializable members. A representation of the JSON value. + + Reads one JSON value (including objects or arrays) from the provided reader into a . + The reader to read. + The type of the object to convert to and return. + A metadata provider for serializable types. + + or is . + The JSON is invalid, is not compatible with the JSON, or a value could not be read from the reader. + + is using unsupported options. + There is no compatible for or its serializable members. + The method on the provided did not return a compatible for . + A representation of the JSON value. + + + Reads the UTF-8 encoded text representing a single JSON value into a . + The Stream will be read to completion. + JSON data to parse. + Options to control the behavior during reading. + The type to deserialize the JSON value into. + + is . + The JSON is invalid, is not compatible with the JSON, or there is remaining data in the Stream. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Reads the UTF-8 encoded text representing a single JSON value into a . + The Stream will be read to completion. + JSON data to parse. + Metadata about the type to convert. + The type to deserialize the JSON value into. + + or is . + The JSON is invalid, is not compatible with the JSON, or there is remaining data in the Stream. + There is no compatible for or its serializable members. + A representation of the JSON value. + Parses the UTF-8 encoded text representing a single JSON value into an instance of the type specified by a generic type parameter. The JSON text to parse. @@ -869,6 +1245,55 @@ There is remaining data in the span beyond a single JSON value. There is no compatible for or its serializable members. A representation of the JSON value. + + Parses the UTF-8 encoded text representing a single JSON value into a . + JSON text to parse. + Metadata about the type to convert. + The type to deserialize the JSON value into. + The JSON is invalid, is not compatible with the JSON, or there is remaining data in the Stream. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Parses the text representing a single JSON value into an instance of the type specified by a generic type parameter. + The JSON text to parse. + Options to control the behavior during parsing. + The type to deserialize the JSON value into. + The JSON is invalid. + +-or- + + is not compatible with the JSON. + +-or- + +There is remaining data in the span beyond a single JSON value. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Parses the text representing a single JSON value into a . + JSON text to parse. + Metadata about the type to convert. + The type to deserialize the JSON value into. + + is . + +-or- + + is . + The JSON is invalid. + +-or- + + is not compatible with the JSON. + +-or- + +There is remaining data in the string beyond a single JSON value. + There is no compatible for or its serializable members. + A representation of the JSON value. + Parses the text representing a single JSON value into an instance of the type specified by a generic type parameter. The JSON text to parse. @@ -888,6 +1313,101 @@ There is remaining data in the string beyond a single JSON value. There is no compatible for or its serializable members. A representation of the JSON value. + + Parses the text representing a single JSON value into a . + JSON text to parse. + Metadata about the type to convert. + The type to deserialize the JSON value into. + + is . + +-or- + + is . + The JSON is invalid. + +-or- + + is not compatible with the JSON. + +-or- + +There is remaining data in the string beyond a single JSON value. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + Options to control the behavior during parsing. + The type to deserialize the JSON value into. + + is . + + is not compatible with the JSON. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + Metadata about the type to convert. + The type to deserialize the JSON value into. + + is . + +-or- + + is . + + is not compatible with the JSON. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + Options to control the behavior during parsing. + The type to deserialize the JSON value into. + + is not compatible with the JSON. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + Metadata about the type to convert. + The type to deserialize the JSON value into. + + is . + + is not compatible with the JSON. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + Options to control the behavior during parsing. + The type to deserialize the JSON value into. + + is not compatible with the JSON. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the representing a single JSON value into a . + The to convert. + Metadata about the type to convert. + The type to deserialize the JSON value into. + + is . + + is not compatible with the JSON. + There is no compatible for or its serializable members. + A representation of the JSON value. + Reads one JSON value (including objects or arrays) from the provided reader into an instance of the type specified by a generic type parameter. The reader to read the JSON from. @@ -907,6 +1427,29 @@ A value could not be read from the reader. There is no compatible for or its serializable members. A representation of the JSON value. + + Reads one JSON value (including objects or arrays) from the provided reader into a . + The reader to read. + Metadata about the type to convert. + The type to deserialize the JSON value into. + The JSON is invalid, is not compatible with the JSON, or a value could not be read from the reader. + + is using unsupported options. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Reads the UTF-8 encoded text representing a single JSON value into an instance specified by the . + The Stream will be read to completion. + JSON data to parse. + Metadata about the type to convert. + The that can be used to cancel the read operation. + + or is . + The JSON is invalid, + or when there is remaining data in the Stream. + A representation of the JSON value. + Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a specified type. The stream will be read to completion. The JSON data to parse. @@ -927,6 +1470,20 @@ There is remaining data in the stream. There is no compatible for or its serializable members. A representation of the JSON value. + + Reads the UTF-8 encoded text representing a single JSON value into a . + The Stream will be read to completion. + JSON data to parse. + The type of the object to convert to and return. + A metadata provider for serializable types. + The that can be used to cancel the read operation. + + , , or is . + The JSON is invalid, the is not compatible with the JSON, or there is remaining data in the Stream. + There is no compatible for or its serializable members. + The method on the provided did not return a compatible for . + A representation of the JSON value. + Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a type specified by a generic type parameter. The stream will be read to completion. The JSON data to parse. @@ -947,6 +1504,83 @@ There is remaining data in the stream. is . A representation of the JSON value. + + Reads the UTF-8 encoded text representing a single JSON value into a . + The Stream will be read to completion. + JSON data to parse. + Metadata about the type to convert. + The which may be used to cancel the read operation. + The type to deserialize the JSON value into. + + or is . + The JSON is invalid, is not compatible with the JSON, or there is remaining data in the Stream. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Wraps the UTF-8 encoded text into an that can be used to deserialize root-level JSON arrays in a streaming manner. + JSON data to parse. + Options to control the behavior during reading. + The which may be used to cancel the read operation. + The element type to deserialize asynchronously. + + is . + An representation of the provided JSON array. + + + Wraps the UTF-8 encoded text into an that can be used to deserialize root-level JSON arrays in a streaming manner. + JSON data to parse. + Metadata about the element type to convert. + The that can be used to cancel the read operation. + The element type to deserialize asynchronously. + + or is . + An representation of the provided JSON array. + + + Converts the provided value to UTF-8 encoded JSON text and write it to the . + The UTF-8 to write to. + The value to convert. + Metadata about the type to convert. + + is . + + does not match the type of . + + + Converts the provided value to UTF-8 encoded JSON text and write it to the . + The UTF-8 to write to. + The value to convert. + The type of the to convert. + Options to control the conversion behavior. + + is not compatible with . + + or is . + There is no compatible for or its serializable members. + + + Converts the provided value to UTF-8 encoded JSON text and write it to the . + The UTF-8 to write to. + The value to convert. + The type of the to convert. + A metadata provider for serializable types. + + is not compatible with . + + , , or is . + There is no compatible for or its serializable members. + + + Converts the provided value into a . + The value to convert. + Metadata about the type to convert. + + is . + + does not match the type of . + A representation of the value. + Converts the value of a specified type into a JSON string. The value to convert. @@ -959,6 +1593,27 @@ There is remaining data in the stream. There is no compatible for or its serializable members. The JSON string representation of the value. + + Converts the provided value into a . + The value to convert. + The type of the to convert. + A metadata provider for serializable types. + There is no compatible for or its serializable members. + The method of the provided returns for the type to convert. + + or is . + A representation of the value. + + + Writes one JSON value (including objects or arrays) to the provided writer. + The writer to write. + The value to convert and write. + Metadata about the type to convert. + + or is . + + does not match the type of . + Writes the JSON representation of the specified type to the provided writer. The JSON writer to write to. @@ -971,6 +1626,19 @@ There is remaining data in the stream. or is . There is no compatible for or its serializable members. + + Writes one JSON value (including objects or arrays) to the provided writer. + A JSON writer to write to. + The value to convert and write. + The type of the to convert. + A metadata provider for serializable types. + + is not compatible with . + + or is . + There is no compatible for or its serializable members. + The method of the provided returns for the type to convert. + Converts the value of a type specified by a generic type parameter into a JSON string. The value to convert. @@ -979,6 +1647,36 @@ There is remaining data in the stream. There is no compatible for or its serializable members. A JSON string representation of the value. + + Converts the provided value into a . + The value to convert. + Metadata about the type to convert. + The type of the value to serialize. + There is no compatible for or its serializable members. + + is . + A representation of the value. + + + Converts the provided value to UTF-8 encoded JSON text and write it to the . + The UTF-8 to write to. + The value to convert. + Options to control the conversion behavior. + The type of the value to serialize. + + is . + There is no compatible for or its serializable members. + + + Converts the provided value to UTF-8 encoded JSON text and write it to the . + The UTF-8 to write to. + The value to convert. + Metadata about the type to convert. + The type of the value to serialize. + + is . + There is no compatible for or its serializable members. + Writes the JSON representation of a type specified by a generic type parameter to the provided writer. A JSON writer to write to. @@ -989,6 +1687,28 @@ There is remaining data in the stream. is . There is no compatible for or its serializable members. + + Writes one JSON value (including objects or arrays) to the provided writer. + The writer to write. + The value to convert and write. + Metadata about the type to convert. + The type of the value to serialize. + + or is . + There is no compatible for or its serializable members. + + + Converts the provided value to UTF-8 encoded JSON text and writes it to the . + The UTF-8 to write to. + The value to convert. + Metadata about the type to convert. + The that can be used to cancel the write operation. + + is . + + does not match the type of . + A task that represents the asynchronous write operation. + Asynchronously converts the value of a specified type to UTF-8 encoded JSON text and writes it to the specified stream. The UTF-8 stream to write to. @@ -1003,6 +1723,20 @@ There is remaining data in the stream. There is no compatible for or its serializable members. A task that represents the asynchronous write operation. + + Converts the provided value to UTF-8 encoded JSON text and write it to the . + The UTF-8 to write to. + The value to convert. + The type of the to convert. + A metadata provider for serializable types. + The that can be used to cancel the write operation. + + is not compatible with . + + , , or is . + There is no compatible for or its serializable members. + A task that represents the asynchronous write operation. + Asynchronously converts a value of a type specified by a generic type parameter to UTF-8 encoded JSON text and writes it to a stream. The UTF-8 stream to write to. @@ -1015,6 +1749,181 @@ There is remaining data in the stream. There is no compatible for or its serializable members. A task that represents the asynchronous write operation. + + Converts the provided value to UTF-8 encoded JSON text and write it to the . + The UTF-8 to write to. + The value to convert. + Metadata about the type to convert. + The that can be used to cancel the write operation. + The type of the value to serialize. + + is . + There is no compatible for or its serializable members. + A task that represents the asynchronous write operation. + + + Converts the provided value into a . + The value to convert. + Metadata about the type to convert. + + is . + + does not match the type of . + A representation of the value. + + + Converts the provided value into a . + The value to convert. + The type of the to convert. + Options to control the conversion behavior. + + is not compatible with . + + is . + There is no compatible for or its serializable members. + A representation of the value. + + + Converts the provided value into a . + The value to convert. + The type of the to convert. + A metadata provider for serializable types. + There is no compatible for or its serializable members. + The method of the provided returns for the type to convert. + + or is . + A representation of the value. + + + Converts the provided value into a . + The value to convert. + Options to control the conversion behavior. + The type of the value to serialize. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the provided value into a . + The value to convert. + Metadata about the type to convert. + The type of the value to serialize. + There is no compatible for or its serializable members. + + is . + A representation of the value. + + + Converts the provided value into a . + The value to convert. + Metadata about the type to convert. + + is . + + does not match the type of . + A representation of the value. + + + Converts the provided value into a . + The value to convert. + The type of the to convert. + Options to control the conversion behavior. + + is not compatible with . + + is . + There is no compatible for or its serializable members. + A representation of the value. + + + Converts the provided value into a . + The value to convert. + The type of the to convert. + A metadata provider for serializable types. + There is no compatible for or its serializable members. + The method of the provided returns for the type to convert. + + or is . + A representation of the value. + + + Converts the provided value into a . + The value to convert. + Options to control the conversion behavior. + The type of the value to serialize. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the provided value into a . + The value to convert. + Metadata about the type to convert. + The type of the value to serialize. + There is no compatible for or its serializable members. + + is . + A representation of the value. + + + Converts the provided value into a . + The value to convert. + Metadata about the type to convert. + + is . + + does not match the type of . + A representation of the value. + + + Converts the provided value into a . + The value to convert. + The type of the to convert. + Options to control the conversion behavior. + + is not compatible with . + + is . + There is no compatible for or its serializable members. + A representation of the value. + + + Converts the provided value into a . + The value to convert. + The type of the to convert. + A metadata provider for serializable types. + There is no compatible for or its serializable members. + The method of the provided returns for the type to convert. + + or is . + A representation of the value. + + + Converts the provided value into a . + The value to convert. + Options to control the conversion behavior. + The type of the value to serialize. + There is no compatible for or its serializable members. + A representation of the JSON value. + + + Converts the provided value into a . + The value to convert. + Metadata about the type to convert. + The type of the value to serialize. + There is no compatible for or its serializable members. + + is . + A representation of the value. + + + Converts the provided value into a array. + The value to convert. + Metadata about the type to convert. + + is . + + does not match the type of . + A UTF-8 representation of the value. + Converts a value of the specified type into a JSON string, encoded as UTF-8 bytes. The value to convert. @@ -1027,6 +1936,19 @@ There is remaining data in the stream. There is no compatible for or its serializable members. A JSON string representation of the value, encoded as UTF-8 bytes. + + Converts the provided value into a array. + The value to convert. + The type of the to convert. + A metadata provider for serializable types. + + is not compatible with . + + is . + There is no compatible for or its serializable members. + The method of the provided returns for the type to convert. + A UTF-8 representation of the value. + Converts the value of a type specified by a generic type parameter into a JSON string, encoded as UTF-8 bytes. The value to convert. @@ -1035,14 +1957,36 @@ There is remaining data in the stream. There is no compatible for or its serializable members. A JSON string representation of the value, encoded as UTF-8 bytes. + + Converts the provided value into a array. + The value to convert. + Metadata about the type to convert. + The type of the value to serialize. + There is no compatible for or its serializable members. + + is . + A UTF-8 representation of the value. + + + Indicates whether unconfigured instances should be set to use the reflection-based . + - Specifies what default options are used by . + Specifies scenario-based default serialization options that can be used to construct a instance. - Specifies that general-purpose values should be used. These are the same settings applied if a isn't specified. + + General-purpose option values. These are the same settings that are applied if a member isn't specified. + For information about the default property values that are applied, see JsonSerializerOptions properties. + - Specifies that values should be used more appropriate to web-based scenarios. + + Option values appropriate to Web-based scenarios. + This member implies that: + - Property names are treated as case-insensitive. + - "camelCase" name formatting should be employed. + - Quoted numbers (JSON strings for number properties) are allowed. + Provides options to be used with . @@ -1060,12 +2004,49 @@ There is remaining data in the stream. is . + + Appends a new to the metadata resolution of the current instance. + The generic definition of the specified context type. + Returns the converter for the specified type. The type to return a converter for. The configured for returned an invalid converter. There is no compatible for or its serializable members. - The first converter that supports the given type, or if there is no converter. + The first converter that supports the given type. + + + Gets the contract metadata resolved by the current instance. + The type to resolve contract metadata for. + + is . + + is not valid for serialization. + The contract metadata resolved for . + + + Marks the current instance as read-only to prevent any further user modification. + The instance does not specify a setting. + + + Marks the current instance as read-only preventing any further user modification. + Populates unconfigured properties with the reflection-based default. + + The instance does not specify a setting. Thrown when is . + -or- + The feature switch has been turned off. + + + + Tries to get the contract metadata resolved by the current instance. + The type to resolve contract metadata for. + When this method returns, contains the resolved contract metadata, or if the contract could not be resolved. + + is . + + is not valid for serialization. + + if a contract for was found, or otherwise. Get or sets a value that indicates whether an extra comma at the end of a list of JSON values in an object or array is allowed (and ignored) within the JSON payload being deserialized. @@ -1077,6 +2058,9 @@ There is remaining data in the stream. Gets the list of user-defined converters that were registered. The list of custom converters. + + Gets a read-only, singleton instance of that uses the default configuration. + Gets or sets the default buffer size, in bytes, to use when creating temporary buffers. The buffer size is less than 1. @@ -1084,7 +2068,7 @@ There is remaining data in the stream. The default buffer size in bytes. - Specifies a condition to determine when properties with default values are ignored during serialization or deserialization. + Gets or sets a value that determines when properties with default values are ignored during serialization or deserialization. The default value is . This property is set to . This property is set after serialization or deserialization has occurred. @@ -1102,31 +2086,36 @@ There is remaining data in the stream. The JavaScript character encoding. - Gets or sets a value that determines whether values are ignored during serialization and deserialization. The default value is . + Gets or sets a value that indicates whether values are ignored during serialization and deserialization. The default value is . This property was set after serialization or deserialization has occurred. -or- has been set to a non-default value. These properties cannot be used together. - to ignore null values during serialization and deserialization; otherwise, see langword="false" />. + if null values are ignored during serialization and deserialization; otherwise, . - Determines whether read-only fields are ignored during serialization. A property is read-only if it isn't marked with the keyword. The default value is . + Gets or sets a value that indicates whether read-only fields are ignored during serialization. A field is read-only if it is marked with the keyword. The default value is . This property is set after serialization or deserialization has occurred. - if read-only fields should be ignored during serialization; otherwise. + if read-only fields are ignored during serialization; otherwise. - Gets a value that determines whether read-only properties are ignored during serialization. The default value is . + Gets a value that indicates whether read-only properties are ignored during serialization. The default value is . This property was set after serialization or deserialization has occurred. - to ignore read-only properties during serialization; otherwise, . + if read-only properties are ignored during serialization; otherwise, . - Determines whether fields are handled serialization and deserialization. + Gets or sets a value that indicates whether fields are handled during serialization and deserialization. The default value is . This property is set after serialization or deserialization has occurred. + + if fields are included during serialization; otherwise, . + + + Gets a value that indicates whether the current instance has been locked for user modification. Gets or sets the maximum depth allowed when serializing or deserializing JSON, with the default value of 0 indicating a maximum depth of 64. @@ -1135,13 +2124,17 @@ There is remaining data in the stream. The maximum depth allowed when serializing or deserializing JSON. - Specifies how number types should be handled when serializing or deserializing. + Gets or sets an object that specifies how number types should be handled when serializing or deserializing. This property is set after serialization or deserialization has occurred. + + Gets or sets the preferred object creation handling for properties when deserializing JSON. + When set to , all properties that are capable of reusing the existing instance will be populated. + - Gets or sets a value that determines whether a property's name uses a case-insensitive comparison during deserialization. The default value is . + Gets or sets a value that indicates whether a property's name uses a case-insensitive comparison during deserialization. The default value is . - to compare property names using case-insensitive comparison; otherwise, . + if property names are compared case-insensitively; otherwise, . Gets or sets a value that specifies the policy used to convert a property's name on an object to another format, such as camel-casing, or to leave property names unchanged. @@ -1154,13 +2147,26 @@ There is remaining data in the stream. A value that indicates whether comments are allowed, disallowed, or skipped. - Configures how object references are handled when reading and writing JSON. + Gets or sets an object that specifies how object references are handled when reading and writing JSON. + + + Gets or sets the contract resolver used by this instance. + The property is set after serialization or deserialization has occurred. + + + Gets the list of chained contract resolvers used by this instance. + + + Gets or sets an object that specifies how deserializing a type declared as an is handled during deserialization. + + + Gets or sets an object that specifies how handles JSON properties that cannot be mapped to a specific .NET member when deserializing object types. - Gets or sets a value that defines whether JSON should use pretty printing. By default, JSON is serialized without any extra white space. + Gets or sets a value that indicates whether JSON should use pretty printing. By default, JSON is serialized without any extra white space. This property was set after serialization or deserialization has occurred. - if JSON should pretty print on serialization; otherwise, . The default is . + if JSON is pretty printed on serialization; otherwise, . The default is . Defines the various JSON tokens that make up a JSON text. @@ -1178,7 +2184,7 @@ There is remaining data in the stream. The token type is the JSON literal false. - There is no value (as distinct from ). + There is no value (as distinct from ). This is the default token type if no data has been read by the . The token type is the JSON literal null. @@ -1238,12 +2244,983 @@ There is remaining data in the stream. Gets or sets a value that indicates whether the should format the JSON output, which includes indenting nested JSON tokens, adding new lines, and adding white space between property names and values. - to format the JSON output; to write without any extra white space. The default is . + if the JSON output is formatted; if the JSON is written without any extra white space. The default is . + + + Gets or sets the maximum depth allowed when writing JSON, with the default (that is, 0) indicating a max depth of 1000. + Thrown when the max depth is set to a negative value. Gets or sets a value that indicates whether the should skip structural validation and allow the user to write invalid JSON. - to skip structural validation and allow invalid JSON; to throw an on any attempt to write invalid JSON. + if structural validation is skipped and invalid JSON is allowed; if an is thrown on any attempt to write invalid JSON. + + + Represents a mutable JSON array. + + + Initializes a new instance of the class that is empty. + Options to control the behavior. + + + Initializes a new instance of the class that contains items from the specified array. + The items to add to the new . + + + Initializes a new instance of the class that contains items from the specified params array. + Options to control the behavior. + The items to add to the new . + + + Adds a to the end of the . + The to be added to the end of the . + + + Adds an object to the end of the . + The object to be added to the end of the . + The type of object to be added. + + + Removes all elements from the . + + + Determines whether an element is in the . + The object to locate in the . + + if is found in the ; otherwise, . + + + Initializes a new instance of the class that contains items from the specified . + The . + Options to control the behavior. + The is not a . + The new instance of the class that contains items from the specified . + + + Returns an enumerator that iterates through the . + An for the . + + + Returns an enumerable that wraps calls to . + The type of the value to obtain from the . + An enumerable iterating over values of the array. + + + The object to locate in the . + The to locate in the . + The index of item if found in the list; otherwise, -1. + + + Inserts an element into the at the specified index. + The zero-based index at which should be inserted. + The to insert. + + is less than 0 or is greater than . + + + Removes the first occurrence of a specific from the . + The to remove from the . + + if is successfully removed; otherwise, . + + + Removes the element at the specified index of the . + The zero-based index of the element to remove. + + is less than 0 or is greater than . + + + Copies the entire to a compatible one-dimensional array, starting at the specified index of the target array. + The one-dimensional that is the destination of the elements copied from . The Array must have zero-based indexing. + The zero-based index in at which copying begins. + + is . + + is less than 0. + The number of elements in the source ICollection is greater than the available space from to the end of the destination . + + + Returns an enumerator that iterates through the . + A for the . + + + Writes the into the provided as JSON. + The . + Options to control the serialization behavior. + + + Gets the number of elements contained in the . + The number of elements contained in the . + + + Returns . + + if the is read-only; otherwise, . + + + The base class that represents a single node within a mutable JSON document. + + + Casts to the derived type. + The node is not a . + A . + + + Casts to the derived type. + The node is not a . + A . + + + Casts to the derived type. + The node is not a . + A . + + + Creates a new instance of the class. All child nodes are recursively cloned. + A new cloned instance of the current node. + + + Compares the values of two nodes, including the values of all descendant nodes. + The to compare. + The to compare. + + if the tokens are equal; otherwise . + + + Returns the index of the current node from the parent . + The current parent is not a . + The index of the current node. + + + Gets the JSON path. + The JSON Path value. + + + Returns the property name of the current node from the parent object. + The current parent is not a . + The property name of the current node. + + + Gets the value for the current . + The type of the value to obtain from the . + The current cannot be represented as a {TValue}. + The current is not a or is not compatible with {TValue}. + A value converted from the instance. + + + Returns the of the current instance. + The json value kind of the current instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to an . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to an . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to an . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to an . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a specified nullable to a nullable . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an explicit conversion of a given to a . + A to explicitly convert. + A value converted from the instance. + + + Defines an implicit conversion of a given to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a given to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a given to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a given to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a given to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a given to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a given to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a given to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a given to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a given to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a given to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a nullable . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Defines an implicit conversion of a specified nullable to a . + A to implicitly convert. + A instance converted from the parameter. + + + Parses a as UTF-8-encoded data representing a single JSON value into a . The Stream will be read to completion. + JSON text to parse. + Options to control the node behavior after parsing. + Options to control the document behavior during parsing. + + does not represent a valid single JSON value. + A representation of the JSON value. + + + Parses text representing a single JSON value. + JSON text to parse. + Options to control the node behavior after parsing. + Options to control the document behavior during parsing. + + does not represent a valid single JSON value. + A representation of the JSON value. + + + Parses text representing a single JSON value. + JSON text to parse. + Options to control the node behavior after parsing. + Options to control the document behavior during parsing. + + is . + + does not represent a valid single JSON value. + A representation of the JSON value. + + + Parses one JSON value (including objects or arrays) from the provided reader. + The reader to read. + Options to control the behavior. + + is using unsupported options. + The current token does not start or represent a value. + A value could not be read from the reader. + The from the reader. + + + Parses a as UTF-8 encoded data representing a single JSON value into a . The stream will be read to completion. + The JSON text to parse. + Options to control the node behavior after parsing. + Options to control the document behavior during parsing. + The token to monitor for cancellation requests. + + does not represent a valid single JSON value. + A to produce a representation of the JSON value. + + + Replaces this node with a new value. + The value that replaces this node. + The type of value to be replaced. + + + Converts the current instance to string in JSON format. + Options to control the serialization behavior. + JSON representation of current instance. + + + Gets a string representation for the current value appropriate to the node type. + A string representation for the current value appropriate to the node type. + + + Writes the into the provided as JSON. + The . + Options to control the serialization behavior. + The parameter is . + + + Gets or sets the element at the specified index. + The zero-based index of the element to get or set. + + is less than 0 or is greater than the number of properties. + The current is not a . + + + Gets or sets the element with the specified property name. + If the property is not found, is returned. + The name of the property to return. + + is . + The current is not a . + + + Gets the options to control the behavior. + + + Gets the parent . + If there is no parent, is returned. + A parent can either be a or a . + + + Gets the root . + + + Options to control behavior. + + + Gets or sets a value that indicates whether property names on are case insensitive. + + if property names are case insensitive; if property names are case sensitive. + + + Represents a mutable JSON object. + + + Initializes a new instance of the class that contains the specified . + The properties to be added. + Options to control the behavior. + + + Initializes a new instance of the class that is empty. + Options to control the behavior. + + + Adds the specified property to the . + The KeyValuePair structure representing the property name and value to add to the . + An element with the same property name already exists in the . + The property name of is . + + + Adds an element with the provided property name and value to the . + The property name of the element to add. + The value of the element to add. + + is . + An element with the same property name already exists in the . + + + Removes all elements from the . + + + Determines whether the contains an element with the specified property name. + The property name to locate in the . + + is . + + if the contains an element with the specified property name; otherwise, . + + + Initializes a new instance of the class that contains properties from the specified . + The . + Options to control the behavior. + The new instance of the class that contains properties from the specified . + + + Returns an enumerator that iterates through the . + An enumerator that iterates through the . + + + Removes the element with the specified property name from the . + The property name of the element to remove. + + is . + + if the element is successfully removed; otherwise, . + + + Determines whether the contains a specific property name and reference. + The element to locate in the . + + if the contains an element with the property name; otherwise, . + + + Copies the elements of the to an array of type KeyValuePair starting at the specified array index. + The one-dimensional Array that is the destination of the elements copied from . + The zero-based index in at which copying begins. + + is . + + is less than 0. + The number of elements in the source ICollection is greater than the available space from to the end of the destination . + + + Removes a key and value from the . + The KeyValuePair structure representing the property name and value to remove from the . + + if the element is successfully removed; otherwise, . + + + Gets the value associated with the specified property name. + The property name of the value to get. + When this method returns, contains the value associated with the specified property name, if the property name is found; otherwise, . + + is . + + if the contains an element with the specified property name; otherwise, . + + + Returns an enumerator that iterates through the . + An enumerator that iterates through the . + + + Returns the value of a property with the specified name. + The name of the property to return. + The JSON value of the property with the specified name. + + if a property with the specified name was found; otherwise, . + + + Writes the into the provided as JSON. + The . + Options to control the serialization behavior. + + + Gets the number of elements contained in . + The number of elements contained in the . + + + Returns . + + if the is read-only; otherwise, . + + + Gets a collection containing the property names in the . + An containing the keys of the object that implements . + + + Gets a collection containing the property values in the . + An containing the values in the object that implements . + + + Represents a mutable JSON value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The underlying value of the new instance. + Options to control the behavior. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The value to create. + Options to control the behavior. + The type of value to create. + The new instance of the class that contains the specified value. + + + Initializes a new instance of the class that contains the specified value. + The value to create. + The that will be used to serialize the value. + Options to control the behavior. + The type of value to create. + The new instance of the class that contains the specified value. + + + Tries to obtain the current JSON value and returns a value that indicates whether the operation succeeded. + When this method returns, contains the parsed value. + The type of value to obtain. + + if the value can be successfully obtained; otherwise, . + + + Specifies that the JSON type should have its method called after deserialization occurs. + + + The method that is called after deserialization. + + + Specifies that the type should have its method called before deserialization occurs. + + + The method that is called before deserialization. + + + Specifies that the type should have its method called after serialization occurs. + + + The method that is called after serialization. + + + Specifies that the type should have its method called before serialization occurs. + + + The method that is called before serialization. Provides the base class for serialization attributes. @@ -1266,6 +3243,9 @@ There is remaining data in the stream. if the instance can convert the specified object type; otherwise, . + + Gets the type being converted by the current converter instance. + Converts an object or value to or from JSON. The type of object or value handled by the converter. @@ -1286,14 +3266,30 @@ There is remaining data in the stream. An object that specifies serialization options to use. The converted value. + + Reads a dictionary key from a JSON property name. + The to read from. + The type to convert. + The options to use when reading the value. + The value that was converted. + Writes a specified value as JSON. The writer to write to. The value to convert to JSON. An object that specifies serialization options to use. + + Writes a dictionary key as a JSON property name. + The to write to. + The value to convert. The value of determines if the converter handles values. + The options to use when writing the value. + - Indicates whether should be passed to the converter on serialization, and whether should be passed on deserialization. + Gets a value that indicates whether should be passed to the converter on serialization, and whether should be passed on deserialization. + + + Gets the type being converted by the current converter instance. When placed on a property or type, specifies the converter type to use. @@ -1318,7 +3314,7 @@ There is remaining data in the stream. Supports converting several types by using a factory pattern. - When overidden in a derived class, initializes a new instance of the class. + When overridden in a derived class, initializes a new instance of the class. Creates a converter for a specified type. @@ -1326,11 +3322,37 @@ There is remaining data in the stream. The serialization options to use. A converter for which is compatible with . + + Gets the type being converted by the current converter instance. + + + When placed on a type declaration, indicates that the specified subtype should be opted into polymorphic serialization. + + + Initializes a new attribute with specified parameters. + A derived type that should be supported in polymorphic serialization of the declared based type. + + + Initializes a new attribute with specified parameters. + A derived type that should be supported in polymorphic serialization of the declared base type. + The type discriminator identifier to be used for the serialization of the subtype. + + + Initializes a new attribute with specified parameters. + A derived type that should be supported in polymorphic serialization of the declared base type. + The type discriminator identifier to be used for the serialization of the subtype. + + + A derived type that should be supported in polymorphic serialization of the declared base type. + + + The type discriminator identifier to be used for the serialization of the subtype. + When placed on a property of type , any properties that do not have a matching member are added to that dictionary during deserialization and written during serialization. - Instantiates a new instance of the class. + Initializes a new instance of the class. Prevents a property from being serialized or deserialized. @@ -1339,22 +3361,22 @@ There is remaining data in the stream. Initializes a new instance of . - Specifies the condition that must be met before a property will be ignored. + Gets or sets the condition that must be met before a property will be ignored. Controls how the ignores properties on serialization and deserialization. - Property will always be ignored. + Property is always ignored. - Property will always be serialized and deserialized, regardless of configuration. + Property is always serialized and deserialized, regardless of configuration. - Property will only be ignored if it is . + Property is ignored only if it equals the default value for its type. - If the value is , the property is ignored during serialization. This is applied only to reference-type properties and fields. + Property is ignored if its value is . This is applied only to reference-type properties and fields. Indicates that the member should be included for serialization and deserialization. @@ -1363,6 +3385,46 @@ There is remaining data in the stream. Initializes a new instance of . + + The to be used at run time. + + + Specifies that the built-in be used to convert JSON property names. + + + Specifies that the built-in be used to convert JSON property names. + + + Specifies that the built-in policy be used to convert JSON property names. + + + Specifies that the built-in policy be used to convert JSON property names. + + + Specifies that the built-in policy be used to convert JSON property names. + + + Specifies that JSON property names should not be converted. + + + Converter to convert enums to and from numeric values. + The enum type that this converter targets. + + + Initializes a new instance of . + + + When overridden in a derived class, determines whether the converter instance can convert the specified object type. + The type of the object to check whether it can be converted by this converter instance. + + true if the instance can convert the specified object type; otherwise, false. + + + Creates a converter for a specified type. + The type handled by the converter. + The serialization options to use. + A converter for which T is compatible with typeToConvert. + Determines how handles numbers when serializing and deserializing. @@ -1389,6 +3451,43 @@ There is remaining data in the stream. Indicates what settings should be used when serializing or deserializing numbers. An object that determines the number serialization and deserialization settings. + + Determines how deserialization will handle object creation for fields or properties. + + + Attempt to populate any instances already found on a deserialized field or property. + + + A new instance will always be created when deserializing a field or property. + + + Determines how deserialization handles object creation for fields or properties. + + + Initializes a new instance of . + The handling to apply to the current member. + + + Gets the configuration to use when deserializing members. + + + When placed on a type, indicates that the type should be serialized polymorphically. + + + Creates a new instance. + + + Gets or sets a value that indicates whether the deserializer should ignore any unrecognized type discriminator IDs and revert to the contract of the base type. + + to instruct the deserializer to ignore any unrecognized type discriminator IDs and revert to the contract of the base type; to fail the deserialization for unrecognized type discriminator IDs. + + + Gets or sets a custom type discriminator property name for the polymorhic type. + Uses the default '$type' property name if left unset. + + + Gets or sets the behavior when serializing an undeclared derived runtime type. + Specifies the property name that is present in the JSON when serializing and deserializing. This overrides any naming policy specified by . @@ -1400,6 +3499,142 @@ There is remaining data in the stream. Gets the name of the property. The name of the property. + + Specifies the property order that is present in the JSON when serializing. Lower values are serialized first. + If the attribute is not specified, the default value is 0. + + + Initializes a new instance of with the specified order. + The order of the property. + + + Gets the serialization order of the property. + The serialization order of the property. + + + Indicates that the annotated member must bind to a JSON property on deserialization. + + + Initializes a new instance of . + + + Instructs the System.Text.Json source generator to generate source code to help optimize performance when serializing and deserializing instances of the specified type and types in its object graph. + + + Initializes a new instance of with the specified type. + The type to generate source code for. + + + Gets or sets the mode that indicates what the source generator should generate for the type. If the value is , then the setting specified on will be used. + + + Gets or sets the name of the property for the generated for the type on the generated, derived type. + + + Provides metadata about a set of types that is relevant to JSON serialization. + + + Creates an instance of and binds it with the indicated . + The run time provided options for the context instance. + + + Gets metadata for the specified type. + The type to fetch metadata for. + The metadata for the specified type, or if the context has no metadata for the type. + + + Resolves a contract for the requested type and options. + The type to be resolved. + The configuration to use when resolving the metadata. + A instance matching the requested type, or if no contract could be resolved. + + + Gets the default run-time options for the context. + + + Gets the run-time specified options of the context. If no options were passed when instantiating the context, then a new instance is bound and returned. + + + The generation mode for the System.Text.Json source generator. + + + When specified on , indicates that both type-metadata initialization logic and optimized serialization logic should be generated for all types. When specified on , indicates that the setting on should be used. + + + Instructs the JSON source generator to generate type-metadata initialization logic. + + + Instructs the JSON source generator to generate optimized serialization logic. + + + Instructs the System.Text.Json source generator to assume the specified options will be used at run time via . + + + Initializes a new instance of . + + + Constructs a new instance with a predefined set of options determined by the specified . + The to reason about. + + is invalid. + + + Gets or sets the default value of . + + + Gets or sets the default value of . + + + Gets or sets the default value of . + + + Gets or sets the default ignore condition. + + + Gets or sets the default value of . + + + Gets or sets the source generation mode for types that don't explicitly set the mode with . + + + Gets or sets a value that indicates whether to ignore read-only fields. + + + Gets or sets a value that indicates whether to ignore read-only properties. + + + Gets or sets a value that indicates whether to include fields for serialization and deserialization. + + + Gets or sets the default value of . + + + Gets or sets the default value of . + + + Gets or sets the default value of . + + + Gets or sets the default value of . + + + Gets or sets a built-in naming policy to convert JSON property names with. + + + Gets or sets the default value of . + + + Gets or sets the default value of . + + + Gets or sets the default value of . + + + Gets or sets a value that indicates whether the source generator defaults to instead of numeric serialization for all enum types encountered in its type graph. + + + Gets or sets a value that indicates whether JSON output is pretty-printed. + Converts enumeration values to and from strings. @@ -1416,16 +3651,837 @@ There is remaining data in the stream. Determines whether the specified type can be converted to an enum. The type to be checked. - if the type can be converted; otherwise, . + true if the type can be converted; otherwise, false. Creates a converter for the specified type. The type handled by the converter. The serialization options to use. - A converter for which is compatible with . + A converter for which T is compatible with typeToConvert. + + + Converter to convert enums to and from strings. + The enum type that this converter targets. + + + Initializes a new instance of with the default naming policy and that allows integer values. + + + Initializes a new instance of . + Optional naming policy for writing enum values. + + to allow undefined enum values. When , if an enum value isn't defined, it outputs as a number rather than a string. + + + When overridden in a derived class, determines whether the converter instance can convert the specified object type. + The type of the object to check whether it can be converted by this converter instance. + + true if the instance can convert the specified object type; otherwise, false. + + + Creates a converter for a specified type. + The type handled by the converter. + The serialization options to use. + A converter for which T is compatible with typeToConvert. + + + Defines how objects of a derived runtime type that has not been explicitly declared for polymorphic serialization should be handled. + + + An object of undeclared runtime type will fail polymorphic serialization. + + + An object of undeclared runtime type will fall back to the serialization contract of the base type. + + + An object of undeclared runtime type will revert to the serialization contract of the nearest declared ancestor type. + Certain interface hierarchies are not supported due to diamond ambiguity constraints. + + + Defines how deserializing a type declared as an is handled during deserialization. + + + A type declared as is deserialized as a . + + + A type declared as is deserialized as a . + + + Determines how handles JSON properties that cannot be mapped to a specific .NET member when deserializing object types. + + + Throws an exception when an unmapped property is encountered. + + + Silently skips any unmapped properties. This is the default behavior. + + + When placed on a type, determines the configuration for the specific type, overriding the global setting. + + + Initializes a new instance of . + The handling to apply to the current member. + + + Gets the unmapped member handling setting for the attribute. + + + Defines the default, reflection-based JSON contract resolver used by System.Text.Json. + + + Creates a mutable instance. + + + Resolves a JSON contract for a given and configuration. + The type for which to resolve a JSON contract. + A instance used to determine contract configuration. + + or is . + A defining a reflection-derived JSON contract for . + + + Gets a list of user-defined callbacks that can be used to modify the initial contract. + + + Used to resolve the JSON serialization contract for requested types. + + + Resolves a contract for the requested type and options. + Type to be resolved. + Configuration used when resolving the metadata. + A instance matching the requested type, or if no contract could be resolved. + + + Provides serialization metadata about a collection type. + The collection type. + + + + A instance representing the element type. + + + If a dictionary type, the instance representing the key type. + + + The option to apply to number collection elements. + + + A to create an instance of the collection when deserializing. + + + An optimized serialization implementation assuming pre-determined defaults. + + + Represents a supported derived type defined in the metadata of a polymorphic type. + + + Initializes a new instance of the class that represents a supported derived type without a type discriminator. + The derived type to be supported by the polymorphic type metadata. + + + Initializes a new instance of the class that represents a supported derived type with an integer type discriminator. + The derived type to be supported by the polymorphic type metadata. + The type discriminator to be associated with the derived type. + + + Initializes a new instance of the class that represents a supported derived type with a string type discriminator. + The derived type to be supported by the polymorphic type metadata. + The type discriminator to be associated with the derived type. + + + Gets a derived type that should be supported in polymorphic serialization of the declared base type. + + + Gets the type discriminator identifier to be used for the serialization of the subtype. + + + Provides helpers to create and initialize metadata for JSON-serializable types. + + + Creates serialization metadata for an array. + The serialization and deserialization options to use. + Provides serialization metadata about the collection type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The serialization and deserialization options to use. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the key type. + The generic definition of the value type. + Serialization metadata for the given type. + + + Creates serialization metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the key type. + The generic definition of the value type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for and types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + A method to create an immutable dictionary instance. + The generic definition of the type. + The generic definition of the key type. + The generic definition of the value type. + Serialization metadata for the given type. + + + Creates metadata for non-dictionary immutable collection types. + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + A method to create an immutable dictionary instance. + The generic definition of the type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the key type. + The generic definition of the value type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates serialization metadata for . + The to use. + Provides serialization metadata about the collection type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for a complex class or struct. + The to use for serialization and deserialization. + Provides serialization metadata about an object type with constructors, properties, and fields. + The type of the class or struct. + + or is . + A instance representing the class or struct. + + + Creates metadata for a property or field. + The to use for serialization and deserialization. + Provides serialization metadata about the property or field. + The type that the converter for the property returns or accepts when converting JSON data. + A instance initialized with the provided metadata. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + A method for adding elements to the collection when using the serializer's code-paths. + The generic definition of the type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates serialization metadata for . + The to use. + Provides serialization metadata about the collection type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + A method for adding elements to the collection when using the serializer's code-paths. + The generic definition of the type. + Serialization metadata for the given type. + + + Creates metadata for types assignable to . + The to use for serialization and deserialization. + Provides serialization metadata about the collection type. + The generic definition of the type. + The generic definition of the element type. + Serialization metadata for the given type. + + + Creates metadata for a primitive or a type with a custom converter. + The to use for serialization and deserialization. + + The generic type definition. + A instance representing the type. + + + Creates a instance that converts values. + The to use for serialization and deserialization. + The generic definition for the enum type. + A instance that converts values. + + + Creates a instance that converts values. + The to use for serialization and deserialization. + The generic definition for the underlying nullable type. + A instance that converts values + + + Creates a instance that converts values. + Serialization metadata for the underlying nullable type. + The generic definition for the underlying nullable type. + A instance that converts values + + + Gets a type converter that throws a . + The generic definition for the type. + A instance that throws + + + Gets an object that converts values. + + + Gets an object that converts byte array values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Returns a instance that converts values. + + + Gets an object that converts values. + An instance that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Returns a instance that converts values. + + + Returns a instance that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Returns a instance that converts values. + + + Gets a JSON converter that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Returns a instance that converts values. + + + Gets an object that converts values. + + + Returns a instance that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Returns a instance that converts values. + + + Gets a JSON converter that converts values. + + + Returns a instance that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Gets an object that converts values. + + + Provides serialization metadata about an object type with constructors, properties, and fields. + The object type to serialize or deserialize. + + + + Provides a mechanism to initialize metadata for a parameterized constructor of the class or struct to be used when deserializing. + + + Gets or sets an object that specifies how number properties and fields should be processed when serializing and deserializing. + + + Gets or sets a mechanism to create an instance of the class or struct using a parameterless constructor during deserialization. + + + Gets or sets a mechanism to create an instance of the class or struct using a parameterized constructor during deserialization. + + + Gets or sets a mechanism to initialize metadata for properties and fields of the class or struct. + + + Gets or sets a serialization implementation for instances of the class or struct that assumes options specified by . + + + Provides information about a constructor parameter required for JSON deserialization. + + + + Gets or sets the default value of the parameter. + + + Gets or sets a value that specifies whether a default value was specified for the parameter. + + + Gets or sets the name of the parameter. + + + Gets or sets the type of the parameter. + + + Gets or sets the zero-based position of the parameter in the formal parameter list. + + + Defines polymorphic configuration for a specified base type. + + + Creates an empty instance. + + + Gets the list of derived types supported in the current polymorphic type configuration. + + + Gets or sets a value that indicates whether the serializer should ignore any unrecognized type discriminator IDs and revert to the contract of the base type. + The parent instance has been locked for further modification. + + if the serializer should ignore any unrecognized type discriminator IDs and revert to the contract of the base type; if the deserialization should fail when an unrecognized type discriminator ID is encountered. + + + Gets or sets a custom type discriminator property name for the polymorhic type. + Uses the default '$type' property name if left unset. + The parent instance has been locked for further modification. + + + Gets or sets the behavior when serializing an undeclared derived runtime type. + The parent instance has been locked for further modification. + + + Provides JSON serialization-related metadata about a property or field. + + + Gets or sets the custom attribute provider for the current property. + The instance has been locked for further modification. + + + Gets or sets a custom converter override for the current property. + The instance has been locked for further modification. + + + Gets or sets a getter delegate for the property. + The instance has been locked for further modification. + + + Gets or sets a value that indicates whether the current property is a special extension data property. + The instance has been locked for further modification. + +-or- + +The current is not valid for use with extension data. + + + Gets or sets a value that indicates whether the current property is required for deserialization to be successful. + The instance has been locked for further modification. + + + Gets or sets the JSON property name used when serializing the property. + + is . + The instance has been locked for further modification. + + + Gets or sets the applied to the current property. + The instance has been locked for further modification. + + + Gets or sets a value indicating if the property or field should be replaced or populated during deserialization. + + + Gets the value associated with the current contract instance. + + + Gets or sets the serialization order for the current property. + The instance has been locked for further modification. + + + Gets the type of the current property. + + + Gets or sets a setter delegate for the property. + The instance has been locked for further modification. + + + Gets or sets a predicate that determines whether the current property value should be serialized. + The instance has been locked for further modification. + + + Provides serialization metadata about a property or field. + The type to convert of the for the property. + + + + A for the property or field, specified by . + + + The declaring type of the property or field. + + + Provides a mechanism to get the property or field's value. + + + Whether the property was annotated with . + + + Specifies a condition for the member to be ignored. + + + Whether the property was annotated with . + + + If , indicates that the member is a property, otherwise indicates the member is a field. + + + Whether the property or field is public. + + + Whether the property or field is a virtual property. + + + The name to be used when processing the property or field, specified by . + + + If the property or field is a number, specifies how it should processed when serializing and deserializing. + + + The name of the property or field. + + + The info for the property or field's type. + + + Provides a mechanism to set the property or field's value. + + + Provides JSON serialization-related metadata about a type. + + + Creates a blank instance for the current . + The declared type for the property. + The property name used in JSON serialization and deserialization. + + or is . + + cannot be used for serialization. + The instance has been locked for further modification. + A blank instance. + + + Creates a blank instance. + The type for which contract metadata is specified. + The instance the metadata is associated with. + + or is . + + cannot be used for serialization. + A blank instance. + + + Creates a blank instance. + The instance the metadata is associated with. + The type for which contract metadata is specified. + + is . + A blank instance. + + + Locks the current instance for further modification. + + + Gets the associated with the current type. + + + Gets or sets a parameterless factory to be used on deserialization. + The instance has been locked for further modification. + +-or- + +A parameterless factory is not supported for the current metadata . + + + Gets a value that indicates whether the current instance has been locked for modification. + + + Gets a value that describes the kind of contract metadata that the current instance specifies. + + + Gets or sets the type-level override. + The instance has been locked for further modification. + An invalid value was specified. + + + Gets or sets a callback to be invoked after deserialization occurs. + The instance has been locked for further modification. + +-or- + +Serialization callbacks are only supported for metadata. + + + Gets or sets a callback to be invoked before deserialization occurs. + The instance has been locked for further modification. + +-or- + +Serialization callbacks are only supported for metadata. + + + Gets or sets a callback to be invoked after serialization occurs. + The instance has been locked for further modification. + +-or- + +Serialization callbacks are only supported for metadata. + + + Gets or sets a callback to be invoked before serialization occurs. + The instance has been locked for further modification. + +-or- + +Serialization callbacks are only supported for metadata. + + + Gets the value associated with the current instance. + + + Gets or sets the from which this metadata instance originated. + The instance has been locked for further modification. + + + Gets or sets a configuration object specifying polymorphism metadata. + + has been associated with a different instance. + The instance has been locked for further modification. + +-or- + +Polymorphic serialization is not supported for the current metadata . + + + Gets or sets the preferred value for properties contained in the type. + The instance has been locked for further modification. + +-or- + +Unmapped member handling is only supported for JsonTypeInfoKind.Object. + Specified an invalid value. + + + Gets the list of metadata corresponding to the current type. + + + Gets the for which the JSON serialization contract is being defined. + + + Gets or sets the type-level override. + The instance has been locked for further modification. + +-or- + +Unmapped member handling is only supported for . + An invalid value was specified. + + + Provides JSON serialization-related metadata about a type. + The generic definition of the type. + + + Gets or sets a parameterless factory to be used on deserialization. + The instance has been locked for further modification. + +-or- + +A parameterless factory is not supported for the current metadata . + + + Serializes an instance of using values specified at design time. + + + Describes the kind of contract metadata a specifies. + + + Type is serialized as a dictionary with key/value pair entries. + + + Type is serialized as a collection with elements. + + + Type is either a simple value or uses a custom converter. + + + Type is serialized as an object with properties. + + + Contains utilities and combinators acting on . + + + Combines multiple sources into one. + Sequence of contract resolvers to be queried for metadata. + + is . + A combining results from . + + + Creates a resolver and applies modifications to the metadata generated by the source . + The source resolver generating metadata. + The delegate that modifies non- results. + A new instance with modifications applied. - This class defines how the deals with references on serialization and deserialization. + Defines how the deals with references on serialization and deserialization. Initializes a new instance of the class. @@ -1434,22 +4490,25 @@ There is remaining data in the stream. Returns the used for each serialization call. The resolver to use for serialization and deserialization. + + Gets an object that indicates whether an object is ignored when a reference cycle is detected during serialization. + - Metadata properties will be honored when deserializing JSON objects and arrays into reference types and written when serializing reference types. This is necessary to create round-trippable JSON from objects that contain cycles or duplicate references. + Gets an object that indicates whether metadata properties are honored when JSON objects and arrays are deserialized into reference types, and written when reference types are serialized. This is necessary to create round-trippable JSON from objects that contain cycles or duplicate references. - This class defines how the deals with references on serialization and deserialization. + Defines how the deals with references on serialization and deserialization. The type of the to create on each serialization or deserialization call. - Initializes a new instance of the generic class that can create a instance of the specified . + Initializes a new instance of the generic class that can create a instance of the specified type. Creates a new of type used for each serialization call. The new resolver to use for serialization and deserialization. - This class defines how the deals with references on serialization and deserialization. + Defines how the deals with references on serialization and deserialization. Defines the core behavior of preserving references on serialization and deserialization. @@ -1482,28 +4541,50 @@ There is remaining data in the stream. The UTF-8 encoded JSON text to process. to indicate that the input sequence contains the entire data to process; to indicate that the input span contains partial data with more data to follow. - An object that contains the reader state. If this is the first call to the constructor, pass the default state; otherwise, pass the value of the property from the previous instance of the . + The reader state. If this is the first call to the constructor, pass the default state; otherwise, pass the value of the property from the previous instance of the . Initializes a new instance of the structure that processes a read-only sequence of UTF-8 encoded text using the specified options. The UTF-8 encoded JSON text to process. - Defines customized behavior of the that differs from the JSON RFC (for example how to handle comments or maximum depth allowed when reading). By default, the follows the JSON RFC strictly; comments within the JSON are invalid, and the maximum depth is 64. + Options that define customized behavior of the that differs from the JSON RFC (for example, how to handle comments or maximum depth allowed when reading). By default, the follows the JSON RFC strictly; comments within the JSON are invalid, and the maximum depth is 64. Initializes a new instance of the structure that processes a read-only span of UTF-8 encoded text and indicates whether the input contains all the text to process. The UTF-8 encoded JSON text to process. to indicate that the input sequence contains the entire data to process; to indicate that the input span contains partial data with more data to follow. - An object that contains the reader state. If this is the first call to the constructor, pass the default state; otherwise, pass the value of the property from the previous instance of the . + The reader state. If this is the first call to the constructor, pass the default state; otherwise, pass the value of the property from the previous instance of the . Initializes a new instance of the structure that processes a read-only span of UTF-8 encoded text using the specified options. The UTF-8 encoded JSON text to process. - Defines customized behavior of the that differs from the JSON RFC (for example how to handle comments or maximum depth allowed when reading). By default, the follows the JSON RFC strictly; comments within the JSON are invalid, and the maximum depth is 64. + Options that define customized behavior of the that differs from the JSON RFC (for example, how to handle comments or maximum depth allowed when reading). By default, the follows the JSON RFC strictly; comments within the JSON are invalid, and the maximum depth is 64. + + + Copies the current JSON token value from the source, unescaped, as UTF-8 bytes to a buffer. + A buffer to write the unescaped UTF-8 bytes into. + The JSON token is not a string, that is, it's not or . + +-or- + +The JSON string contains invalid UTF-8 bytes or invalid UTF-16 surrogates. + The destination buffer is too small to hold the unescaped value. + The number of bytes written to . + + + Copies the current JSON token value from the source, unescaped, as UTF-16 characters to a buffer. + A buffer to write the transcoded UTF-16 characters into. + The JSON token is not a string, that is, it's not or . + +-or- + +The JSON string contains invalid UTF-8 bytes or invalid UTF-16 surrogates. + The destination buffer is too small to hold the unescaped value. + The number of characters written to . Reads the next JSON token value from the source as a . - The value of the JSON token isn't a boolean value (that is, or ). + The value of the JSON token isn't a Boolean value (that is, or ). if the is ; if the is . @@ -1514,7 +4595,7 @@ There is remaining data in the stream. -or- -The JSON token value represents a number less than or greater than . +The JSON token value represents a number less than Byte.MinValue or greater than Byte.MaxValue. The value of the UTF-8 encoded token. @@ -1532,7 +4613,7 @@ The value is incomplete. That is, the JSON string length is not a multiple of 4. The byte array that represents the current JSON token value. - Parses the current JSON token value from the source as a comment, transcoded it as a . + Parses the current JSON token value from the source as a comment and transcodes it as a . The JSON token is not a comment. The comment that represents the current JSON token value. @@ -1567,13 +4648,13 @@ The JSON token value is of an unsupported format. Reads the next JSON token value from the source and parses it to a . The JSON token value isn't a . - The JSON token value represents a number less than or greater than . + The JSON token value represents a number less than Decimal.MinValue or greater than Decimal.MaxValue. The UTF-8 encoded token value parsed to a . Reads the next JSON token value from the source and parses it to a . The JSON token value isn't a . - The JSON token value represents a number less than or greater than . + The JSON token value represents a number less than Double.MinValue or greater than Double.MaxValue. The UTF-8 encoded token value parsed to a . @@ -1593,7 +4674,7 @@ The entire UTF-8 encoded token value cannot be parsed to a or greater than . +The JSON token value represents a number less than Int16.MinValue or greater than Int16.MaxValue. The UTF-8 encoded token value parsed to an . @@ -1603,7 +4684,7 @@ The JSON token value represents a number less than or greater than . +The JSON token value represents a number less than Int32.MinValue or greater than Int32.MaxValue. The UTF-8 encoded token value parsed to an . @@ -1613,7 +4694,7 @@ The JSON token value represents a number less than or greater than . +The JSON token value represents a number less than Int64.MinValue or greater than Int64.MaxValue. The UTF-8 encoded token value parsed to an . @@ -1623,17 +4704,17 @@ The JSON token value represents a number less than or greater than . +The JSON token value represents a number less than SByte.MinValue or greater than SByte.MaxValue. The UTF-8 encoded token value parsed to an . Reads the next JSON token value from the source and parses it to a . The JSON token value isn't a . - The JSON token value represents a number less than or greater than . + The JSON token value represents a number less than Single.MinValue or greater than Single.MaxValue. The UTF-8 encoded token value parsed to a . - Reads the next JSON token value from the source, unescaped, and transcoded as a string. + Reads the next JSON token value from the source unescaped and transcodes it as a string. The JSON token value isn't a string (that is, not a , , or ). -or- @@ -1648,7 +4729,7 @@ The JSON string contains invalid UTF-8 bytes or invalid UTF-16 surrogates. or greater than . +The JSON token value represents a number less than UInt16.MinValue or greater than UInt16.MaxValue. The UTF-8 encoded token value parsed to a . @@ -1658,7 +4739,7 @@ The JSON token value represents a number less than or greater than . +The JSON token value represents a number less than UInt32.MinValue or greater than UInt32.MaxValue. The UTF-8 encoded token value parsed to a . @@ -1668,7 +4749,7 @@ The JSON token value represents a number less than or greater than . +The JSON token value represents a number less than UInt64.MinValue or greater than UInt64.MaxValue. The UTF-8 encoded token value parsed to a . @@ -1692,7 +4773,7 @@ The current depth exceeds the recursive limit set by the maximum depth. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains the byte equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. The JSON token value isn't a . if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . @@ -1706,91 +4787,91 @@ The current depth exceeds the recursive limit set by the maximum depth. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains the date and time value equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. The value of the JSON token isn't a . if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains the date and time value equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. The value of the JSON token isn't a . if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains the decimal equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. The JSON token value isn't a . if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains a double-precision floating point value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. The JSON token value isn't a . if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains the GUID equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. The value of the JSON token isn't a . if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . Tries to parse the current JSON token value from the source as an and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains the 16-bit integer value equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. The JSON token value isn't a . if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . Tries to parse the current JSON token value from the source as an and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains the 32-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. The JSON token value isn't a . if the entire UTF-8 encoded token value can be successfully parsed to an value; otherwise, . Tries to parse the current JSON token value from the source as an and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains the 64-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. The JSON token value isn't a . if the entire UTF-8 encoded token value can be successfully parsed to an value; otherwise, . Tries to parse the current JSON token value from the source as an and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains the signed byte equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. The JSON token value isn't a . if the entire UTF-8 encoded token value can be successfully parsed to an value; otherwise, . Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains the single-precision floating point value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. The JSON token value isn't a . if the entire UTF-8 encoded token value can be successfully parsed to an value; otherwise, . Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains the unsigned 16-bit integer value equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. The JSON token value isn't a . if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains unsigned 32-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. The JSON token value isn't a . if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. - When this method returns, contains the parsed value. + When this method returns, contains unsigned 64-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. The JSON token value isn't a . if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . @@ -1844,7 +4925,7 @@ The current depth exceeds the recursive limit set by the maximum depth. if should be used to get the token value; if should be used instead. - Gets the mode of this instance of the which indicates whether all the JSON data was provided or there is more data to come. + Gets a value that indicates whether all the JSON data was provided or there is more data to come. if the reader was constructed with the input span or sequence containing the entire JSON data to process; if the reader was constructed with an input span or sequence that may contain partial JSON data with more data to follow. @@ -1860,6 +4941,9 @@ The current depth exceeds the recursive limit set by the maximum depth.Gets the type of the last processed JSON token in the UTF-8 encoded JSON text. The type of the last processed JSON token. + + Gets a value that indicates whether the current or properties contain escape sequences per RFC 8259 section 7, and therefore require unescaping before being consumed. + Gets the raw value of the last processed token as a ReadOnlySequence<byte> slice of the input payload, only if the token is contained within multiple segments. A byte read-only sequence. @@ -2308,6 +5392,46 @@ The current depth exceeds the recursive limit set by the maximum depth.The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. Validation is enabled, and this write operation would produce invalid JSON. + + Writes the input as JSON content. It is expected that the input content is a single complete JSON value. + The raw JSON content to write. + + to validate if the input is an RFC 8259-compliant JSON payload; to skip validation. + The length of the input is zero or equal to Int32.MaxValue. + + is , and the input + is not a valid, complete, single JSON value according to the JSON RFC + or the input JSON exceeds a recursive depth of 64. + + + Writes the input as JSON content. It is expected that the input content is a single complete JSON value. + The raw JSON content to write. + + to validate if the input is an RFC 8259-compliant JSON payload; otherwise. + The length of the input is zero or equal to Int32.MaxValue. + + is , and the input is not a valid, complete, single JSON value according to the JSON RFC, or the input JSON exceeds a recursive depth of 64. + + + Writes the input as JSON content. It is expected that the input content is a single complete JSON value. + The raw JSON content to write. + + to validate if the input is an RFC 8259-compliant JSON payload; otherwise. + The length of the input is zero or greater than 715,827,882 (Int32.MaxValue / 3). + + is , and the input is not a valid, complete, single JSON value according to the JSON RFC, or the input JSON exceeds a recursive depth of 64. + + + Writes the input as JSON content. It is expected that the input content is a single complete JSON value. + The raw JSON content to write. + + to validate if the input is an RFC 8259-compliant JSON payload; otherwise. + + is . + The length of the input is zero or greater than 715,827,882 (Int32.MaxValue / 3). + + is , and the input is not a valid, complete, single JSON value according to the JSON RFC, or the input JSON exceeds a recursive depth of 64. + Writes the beginning of a JSON array. The depth of the JSON exceeds the maximum depth of 1,000. @@ -2375,7 +5499,7 @@ Validation is enabled, and the operation would result in writing invalid JSON. - Writes the beginning of a JSON object with a property name specififed as a read-only character span as the key. + Writes the beginning of a JSON object with a property name specified as a read-only character span as the key. The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8. The specified property name is too large. The depth of the JSON exceeds the maximum depth of 1,000. diff --git a/Bin/System.ValueTuple.dll b/Bin/System.ValueTuple.dll index 4ce28fdea..24360e306 100644 Binary files a/Bin/System.ValueTuple.dll and b/Bin/System.ValueTuple.dll differ diff --git a/Scripts/jquery-1.6.4-vsdoc.js b/Scripts/jquery-1.6.4-vsdoc.js deleted file mode 100644 index f9e47c824..000000000 --- a/Scripts/jquery-1.6.4-vsdoc.js +++ /dev/null @@ -1,7024 +0,0 @@ -/* -* This file has been generated to support Visual Studio IntelliSense. -* You should not use this file at runtime inside the browser--it is only -* intended to be used only for design-time IntelliSense. Please use the -* standard jQuery library for all production use. -* -* Comment version: 1.6.4 -*/ - -/*! -* jQuery JavaScript Library v1.6.4 -* http://jquery.com/ -* -* Distributed in whole under the terms of the MIT -* -* Copyright 2010, John Resig -* -* 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. -* -* Includes Sizzle.js -* http://sizzlejs.com/ -* Copyright 2010, The Dojo Foundation -* Released under the MIT and BSD Licenses. -*/ - -(function ( window, undefined ) { -var jQuery = function( selector, context ) { -/// -/// 1: Accepts a string containing a CSS selector which is then used to match a set of elements. -/// 1.1 - $(selector, context) -/// 1.2 - $(element) -/// 1.3 - $(elementArray) -/// 1.4 - $(jQuery object) -/// 1.5 - $() -/// 2: Creates DOM elements on the fly from the provided string of raw HTML. -/// 2.1 - $(html, ownerDocument) -/// 2.2 - $(html, props) -/// 3: Binds a function to be executed when the DOM has finished loading. -/// 3.1 - $(callback) -/// -/// -/// A string containing a selector expression -/// -/// -/// A DOM Element, Document, or jQuery to use as context -/// -/// - - // The jQuery object is actually just the init constructor 'enhanced' - return new jQuery.fn.init( selector, context, rootjQuery ); - }; -jQuery.Deferred = function( func ) { - - var deferred = jQuery._Deferred(), - failDeferred = jQuery._Deferred(), - promise; - // Add errorDeferred methods, then and promise - jQuery.extend( deferred, { - then: function( doneCallbacks, failCallbacks ) { - deferred.done( doneCallbacks ).fail( failCallbacks ); - return this; - }, - always: function() { - return deferred.done.apply( deferred, arguments ).fail.apply( this, arguments ); - }, - fail: failDeferred.done, - rejectWith: failDeferred.resolveWith, - reject: failDeferred.resolve, - isRejected: failDeferred.isResolved, - pipe: function( fnDone, fnFail ) { - return jQuery.Deferred(function( newDefer ) { - jQuery.each( { - done: [ fnDone, "resolve" ], - fail: [ fnFail, "reject" ] - }, function( handler, data ) { - var fn = data[ 0 ], - action = data[ 1 ], - returned; - if ( jQuery.isFunction( fn ) ) { - deferred[ handler ](function() { - returned = fn.apply( this, arguments ); - if ( returned && jQuery.isFunction( returned.promise ) ) { - returned.promise().then( newDefer.resolve, newDefer.reject ); - } else { - newDefer[ action + "With" ]( this === deferred ? newDefer : this, [ returned ] ); - } - }); - } else { - deferred[ handler ]( newDefer[ action ] ); - } - }); - }).promise(); - }, - // Get a promise for this deferred - // If obj is provided, the promise aspect is added to the object - promise: function( obj ) { - if ( obj == null ) { - if ( promise ) { - return promise; - } - promise = obj = {}; - } - var i = promiseMethods.length; - while( i-- ) { - obj[ promiseMethods[i] ] = deferred[ promiseMethods[i] ]; - } - return obj; - } - }); - // Make sure only one callback list will be used - deferred.done( failDeferred.cancel ).fail( deferred.cancel ); - // Unexpose cancel - delete deferred.cancel; - // Call given func if any - if ( func ) { - func.call( deferred, deferred ); - } - return deferred; - }; -jQuery.Event = function( src, props ) { - - // Allow instantiation without the 'new' keyword - if ( !this.preventDefault ) { - return new jQuery.Event( src, props ); - } - - // Event object - if ( src && src.type ) { - this.originalEvent = src; - this.type = src.type; - - // Events bubbling up the document may have been marked as prevented - // by a handler lower down the tree; reflect the correct value. - this.isDefaultPrevented = (src.defaultPrevented || src.returnValue === false || - src.getPreventDefault && src.getPreventDefault()) ? returnTrue : returnFalse; - - // Event type - } else { - this.type = src; - } - - // Put explicitly provided properties onto the event object - if ( props ) { - jQuery.extend( this, props ); - } - - // timeStamp is buggy for some events on Firefox(#3843) - // So we won't rely on the native value - this.timeStamp = jQuery.now(); - - // Mark it as fixed - this[ jQuery.expando ] = true; -}; -jQuery._Deferred = function() { - - var // callbacks list - callbacks = [], - // stored [ context , args ] - fired, - // to avoid firing when already doing so - firing, - // flag to know if the deferred has been cancelled - cancelled, - // the deferred itself - deferred = { - - // done( f1, f2, ...) - done: function() { - if ( !cancelled ) { - var args = arguments, - i, - length, - elem, - type, - _fired; - if ( fired ) { - _fired = fired; - fired = 0; - } - for ( i = 0, length = args.length; i < length; i++ ) { - elem = args[ i ]; - type = jQuery.type( elem ); - if ( type === "array" ) { - deferred.done.apply( deferred, elem ); - } else if ( type === "function" ) { - callbacks.push( elem ); - } - } - if ( _fired ) { - deferred.resolveWith( _fired[ 0 ], _fired[ 1 ] ); - } - } - return this; - }, - - // resolve with given context and args - resolveWith: function( context, args ) { - if ( !cancelled && !fired && !firing ) { - // make sure args are available (#8421) - args = args || []; - firing = 1; - try { - while( callbacks[ 0 ] ) { - callbacks.shift().apply( context, args ); - } - } - finally { - fired = [ context, args ]; - firing = 0; - } - } - return this; - }, - - // resolve with this as context and given arguments - resolve: function() { - deferred.resolveWith( this, arguments ); - return this; - }, - - // Has this deferred been resolved? - isResolved: function() { - return !!( firing || fired ); - }, - - // Cancel - cancel: function() { - cancelled = 1; - callbacks = []; - return this; - } - }; - - return deferred; - }; -jQuery._data = function( elem, name, data ) { - - return jQuery.data( elem, name, data, true ); - }; -jQuery._mark = function( elem, type ) { - - if ( elem ) { - type = (type || "fx") + "mark"; - jQuery.data( elem, type, (jQuery.data(elem,type,undefined,true) || 0) + 1, true ); - } - }; -jQuery._unmark = function( force, elem, type ) { - - if ( force !== true ) { - type = elem; - elem = force; - force = false; - } - if ( elem ) { - type = type || "fx"; - var key = type + "mark", - count = force ? 0 : ( (jQuery.data( elem, key, undefined, true) || 1 ) - 1 ); - if ( count ) { - jQuery.data( elem, key, count, true ); - } else { - jQuery.removeData( elem, key, true ); - handleQueueMarkDefer( elem, type, "mark" ); - } - } - }; -jQuery.acceptData = function( elem ) { - - if ( elem.nodeName ) { - var match = jQuery.noData[ elem.nodeName.toLowerCase() ]; - - if ( match ) { - return !(match === true || elem.getAttribute("classid") !== match); - } - } - - return true; - }; -jQuery.access = function( elems, key, value, exec, fn, pass ) { - - var length = elems.length; - - // Setting many attributes - if ( typeof key === "object" ) { - for ( var k in key ) { - jQuery.access( elems, k, key[k], exec, fn, value ); - } - return elems; - } - - // Setting one attribute - if ( value !== undefined ) { - // Optionally, function values get executed if exec is true - exec = !pass && exec && jQuery.isFunction(value); - - for ( var i = 0; i < length; i++ ) { - fn( elems[i], key, exec ? value.call( elems[i], i, fn( elems[i], key ) ) : value, pass ); - } - - return elems; - } - - // Getting an attribute - return length ? fn( elems[0], key ) : undefined; - }; -jQuery.active = 0; -jQuery.ajax = function( url, options ) { -/// -/// Perform an asynchronous HTTP (Ajax) request. -/// 1 - jQuery.ajax(url, settings) -/// 2 - jQuery.ajax(settings) -/// -/// -/// A string containing the URL to which the request is sent. -/// -/// -/// A set of key/value pairs that configure the Ajax request. All settings are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) below for a complete list of all settings. -/// - - - // If url is an object, simulate pre-1.5 signature - if ( typeof url === "object" ) { - options = url; - url = undefined; - } - - // Force options to be an object - options = options || {}; - - var // Create the final options object - s = jQuery.ajaxSetup( {}, options ), - // Callbacks context - callbackContext = s.context || s, - // Context for global events - // It's the callbackContext if one was provided in the options - // and if it's a DOM node or a jQuery collection - globalEventContext = callbackContext !== s && - ( callbackContext.nodeType || callbackContext instanceof jQuery ) ? - jQuery( callbackContext ) : jQuery.event, - // Deferreds - deferred = jQuery.Deferred(), - completeDeferred = jQuery._Deferred(), - // Status-dependent callbacks - statusCode = s.statusCode || {}, - // ifModified key - ifModifiedKey, - // Headers (they are sent all at once) - requestHeaders = {}, - requestHeadersNames = {}, - // Response headers - responseHeadersString, - responseHeaders, - // transport - transport, - // timeout handle - timeoutTimer, - // Cross-domain detection vars - parts, - // The jqXHR state - state = 0, - // To know if global events are to be dispatched - fireGlobals, - // Loop variable - i, - // Fake xhr - jqXHR = { - - readyState: 0, - - // Caches the header - setRequestHeader: function( name, value ) { - if ( !state ) { - var lname = name.toLowerCase(); - name = requestHeadersNames[ lname ] = requestHeadersNames[ lname ] || name; - requestHeaders[ name ] = value; - } - return this; - }, - - // Raw string - getAllResponseHeaders: function() { - return state === 2 ? responseHeadersString : null; - }, - - // Builds headers hashtable if needed - getResponseHeader: function( key ) { - var match; - if ( state === 2 ) { - if ( !responseHeaders ) { - responseHeaders = {}; - while( ( match = rheaders.exec( responseHeadersString ) ) ) { - responseHeaders[ match[1].toLowerCase() ] = match[ 2 ]; - } - } - match = responseHeaders[ key.toLowerCase() ]; - } - return match === undefined ? null : match; - }, - - // Overrides response content-type header - overrideMimeType: function( type ) { - if ( !state ) { - s.mimeType = type; - } - return this; - }, - - // Cancel the request - abort: function( statusText ) { - statusText = statusText || "abort"; - if ( transport ) { - transport.abort( statusText ); - } - done( 0, statusText ); - return this; - } - }; - - // Callback for when everything is done - // It is defined here because jslint complains if it is declared - // at the end of the function (which would be more logical and readable) - function done( status, nativeStatusText, responses, headers ) { - - // Called once - if ( state === 2 ) { - return; - } - - // State is "done" now - state = 2; - - // Clear timeout if it exists - if ( timeoutTimer ) { - clearTimeout( timeoutTimer ); - } - - // Dereference transport for early garbage collection - // (no matter how long the jqXHR object will be used) - transport = undefined; - - // Cache response headers - responseHeadersString = headers || ""; - - // Set readyState - jqXHR.readyState = status > 0 ? 4 : 0; - - var isSuccess, - success, - error, - statusText = nativeStatusText, - response = responses ? ajaxHandleResponses( s, jqXHR, responses ) : undefined, - lastModified, - etag; - - // If successful, handle type chaining - if ( status >= 200 && status < 300 || status === 304 ) { - - // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. - if ( s.ifModified ) { - - if ( ( lastModified = jqXHR.getResponseHeader( "Last-Modified" ) ) ) { - jQuery.lastModified[ ifModifiedKey ] = lastModified; - } - if ( ( etag = jqXHR.getResponseHeader( "Etag" ) ) ) { - jQuery.etag[ ifModifiedKey ] = etag; - } - } - - // If not modified - if ( status === 304 ) { - - statusText = "notmodified"; - isSuccess = true; - - // If we have data - } else { - - try { - success = ajaxConvert( s, response ); - statusText = "success"; - isSuccess = true; - } catch(e) { - // We have a parsererror - statusText = "parsererror"; - error = e; - } - } - } else { - // We extract error from statusText - // then normalize statusText and status for non-aborts - error = statusText; - if( !statusText || status ) { - statusText = "error"; - if ( status < 0 ) { - status = 0; - } - } - } - - // Set data for the fake xhr object - jqXHR.status = status; - jqXHR.statusText = "" + ( nativeStatusText || statusText ); - - // Success/Error - if ( isSuccess ) { - deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); - } else { - deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); - } - - // Status-dependent callbacks - jqXHR.statusCode( statusCode ); - statusCode = undefined; - - if ( fireGlobals ) { - globalEventContext.trigger( "ajax" + ( isSuccess ? "Success" : "Error" ), - [ jqXHR, s, isSuccess ? success : error ] ); - } - - // Complete - completeDeferred.resolveWith( callbackContext, [ jqXHR, statusText ] ); - - if ( fireGlobals ) { - globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); - // Handle the global AJAX counter - if ( !( --jQuery.active ) ) { - jQuery.event.trigger( "ajaxStop" ); - } - } - } - - // Attach deferreds - deferred.promise( jqXHR ); - jqXHR.success = jqXHR.done; - jqXHR.error = jqXHR.fail; - jqXHR.complete = completeDeferred.done; - - // Status-dependent callbacks - jqXHR.statusCode = function( map ) { - if ( map ) { - var tmp; - if ( state < 2 ) { - for( tmp in map ) { - statusCode[ tmp ] = [ statusCode[tmp], map[tmp] ]; - } - } else { - tmp = map[ jqXHR.status ]; - jqXHR.then( tmp, tmp ); - } - } - return this; - }; - - // Remove hash character (#7531: and string promotion) - // Add protocol if not provided (#5866: IE7 issue with protocol-less urls) - // We also use the url parameter if available - s.url = ( ( url || s.url ) + "" ).replace( rhash, "" ).replace( rprotocol, ajaxLocParts[ 1 ] + "//" ); - - // Extract dataTypes list - s.dataTypes = jQuery.trim( s.dataType || "*" ).toLowerCase().split( rspacesAjax ); - - // Determine if a cross-domain request is in order - if ( s.crossDomain == null ) { - parts = rurl.exec( s.url.toLowerCase() ); - s.crossDomain = !!( parts && - ( parts[ 1 ] != ajaxLocParts[ 1 ] || parts[ 2 ] != ajaxLocParts[ 2 ] || - ( parts[ 3 ] || ( parts[ 1 ] === "http:" ? 80 : 443 ) ) != - ( ajaxLocParts[ 3 ] || ( ajaxLocParts[ 1 ] === "http:" ? 80 : 443 ) ) ) - ); - } - - // Convert data if not already a string - if ( s.data && s.processData && typeof s.data !== "string" ) { - s.data = jQuery.param( s.data, s.traditional ); - } - - // Apply prefilters - inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); - - // If request was aborted inside a prefiler, stop there - if ( state === 2 ) { - return false; - } - - // We can fire global events as of now if asked to - fireGlobals = s.global; - - // Uppercase the type - s.type = s.type.toUpperCase(); - - // Determine if request has content - s.hasContent = !rnoContent.test( s.type ); - - // Watch for a new set of requests - if ( fireGlobals && jQuery.active++ === 0 ) { - jQuery.event.trigger( "ajaxStart" ); - } - - // More options handling for requests with no content - if ( !s.hasContent ) { - - // If data is available, append data to url - if ( s.data ) { - s.url += ( rquery.test( s.url ) ? "&" : "?" ) + s.data; - // #9682: remove data so that it's not used in an eventual retry - delete s.data; - } - - // Get ifModifiedKey before adding the anti-cache parameter - ifModifiedKey = s.url; - - // Add anti-cache in url if needed - if ( s.cache === false ) { - - var ts = jQuery.now(), - // try replacing _= if it is there - ret = s.url.replace( rts, "$1_=" + ts ); - - // if nothing was replaced, add timestamp to the end - s.url = ret + ( (ret === s.url ) ? ( rquery.test( s.url ) ? "&" : "?" ) + "_=" + ts : "" ); - } - } - - // Set the correct header, if data is being sent - if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { - jqXHR.setRequestHeader( "Content-Type", s.contentType ); - } - - // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. - if ( s.ifModified ) { - ifModifiedKey = ifModifiedKey || s.url; - if ( jQuery.lastModified[ ifModifiedKey ] ) { - jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ ifModifiedKey ] ); - } - if ( jQuery.etag[ ifModifiedKey ] ) { - jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ ifModifiedKey ] ); - } - } - - // Set the Accepts header for the server, depending on the dataType - jqXHR.setRequestHeader( - "Accept", - s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[0] ] ? - s.accepts[ s.dataTypes[0] ] + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : - s.accepts[ "*" ] - ); - - // Check for headers option - for ( i in s.headers ) { - jqXHR.setRequestHeader( i, s.headers[ i ] ); - } - - // Allow custom headers/mimetypes and early abort - if ( s.beforeSend && ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || state === 2 ) ) { - // Abort if not done already - jqXHR.abort(); - return false; - - } - - // Install callbacks on deferreds - for ( i in { success: 1, error: 1, complete: 1 } ) { - jqXHR[ i ]( s[ i ] ); - } - - // Get transport - transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); - - // If no transport, we auto-abort - if ( !transport ) { - done( -1, "No Transport" ); - } else { - jqXHR.readyState = 1; - // Send global event - if ( fireGlobals ) { - globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); - } - // Timeout - if ( s.async && s.timeout > 0 ) { - timeoutTimer = setTimeout( function(){ - jqXHR.abort( "timeout" ); - }, s.timeout ); - } - - try { - state = 1; - transport.send( requestHeaders, done ); - } catch (e) { - // Propagate exception as error if not done - if ( state < 2 ) { - done( -1, e ); - // Simply rethrow otherwise - } else { - jQuery.error( e ); - } - } - } - - return jqXHR; - }; -jQuery.ajaxPrefilter = function( dataTypeExpression, func ) { -/// -/// Handle custom Ajax options or modify existing options before each request is sent and before they are processed by $.ajax(). -/// -/// -/// An optional string containing one or more space-separated dataTypes -/// -/// -/// A handler to set default values for future Ajax requests. -/// -/// - - - if ( typeof dataTypeExpression !== "string" ) { - func = dataTypeExpression; - dataTypeExpression = "*"; - } - - if ( jQuery.isFunction( func ) ) { - var dataTypes = dataTypeExpression.toLowerCase().split( rspacesAjax ), - i = 0, - length = dataTypes.length, - dataType, - list, - placeBefore; - - // For each dataType in the dataTypeExpression - for(; i < length; i++ ) { - dataType = dataTypes[ i ]; - // We control if we're asked to add before - // any existing element - placeBefore = /^\+/.test( dataType ); - if ( placeBefore ) { - dataType = dataType.substr( 1 ) || "*"; - } - list = structure[ dataType ] = structure[ dataType ] || []; - // then we add to the structure accordingly - list[ placeBefore ? "unshift" : "push" ]( func ); - } - } - }; -jQuery.ajaxSettings = { "url": 'http://localhost:25813/', -"isLocal": false, -"global": true, -"type": 'GET', -"contentType": 'application/x-www-form-urlencoded', -"processData": true, -"async": true, -"accepts": {}, -"contents": {}, -"responseFields": {}, -"converters": {}, -"flatOptions": {}, -"jsonp": 'callback' }; -jQuery.ajaxSetup = function( target, settings ) { -/// -/// Set default values for future Ajax requests. -/// -/// -/// A set of key/value pairs that configure the default Ajax request. All options are optional. -/// - - if ( settings ) { - // Building a settings object - ajaxExtend( target, jQuery.ajaxSettings ); - } else { - // Extending ajaxSettings - settings = target; - target = jQuery.ajaxSettings; - } - ajaxExtend( target, settings ); - return target; - }; -jQuery.ajaxTransport = function( dataTypeExpression, func ) { - - - if ( typeof dataTypeExpression !== "string" ) { - func = dataTypeExpression; - dataTypeExpression = "*"; - } - - if ( jQuery.isFunction( func ) ) { - var dataTypes = dataTypeExpression.toLowerCase().split( rspacesAjax ), - i = 0, - length = dataTypes.length, - dataType, - list, - placeBefore; - - // For each dataType in the dataTypeExpression - for(; i < length; i++ ) { - dataType = dataTypes[ i ]; - // We control if we're asked to add before - // any existing element - placeBefore = /^\+/.test( dataType ); - if ( placeBefore ) { - dataType = dataType.substr( 1 ) || "*"; - } - list = structure[ dataType ] = structure[ dataType ] || []; - // then we add to the structure accordingly - list[ placeBefore ? "unshift" : "push" ]( func ); - } - } - }; -jQuery.attr = function( elem, name, value, pass ) { - - var nType = elem.nodeType; - - // don't get/set attributes on text, comment and attribute nodes - if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { - return undefined; - } - - if ( pass && name in jQuery.attrFn ) { - return jQuery( elem )[ name ]( value ); - } - - // Fallback to prop when attributes are not supported - if ( !("getAttribute" in elem) ) { - return jQuery.prop( elem, name, value ); - } - - var ret, hooks, - notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); - - // Normalize the name if needed - if ( notxml ) { - name = jQuery.attrFix[ name ] || name; - - hooks = jQuery.attrHooks[ name ]; - - if ( !hooks ) { - // Use boolHook for boolean attributes - if ( rboolean.test( name ) ) { - hooks = boolHook; - - // Use nodeHook if available( IE6/7 ) - } else if ( nodeHook ) { - hooks = nodeHook; - } - } - } - - if ( value !== undefined ) { - - if ( value === null ) { - jQuery.removeAttr( elem, name ); - return undefined; - - } else if ( hooks && "set" in hooks && notxml && (ret = hooks.set( elem, value, name )) !== undefined ) { - return ret; - - } else { - elem.setAttribute( name, "" + value ); - return value; - } - - } else if ( hooks && "get" in hooks && notxml && (ret = hooks.get( elem, name )) !== null ) { - return ret; - - } else { - - ret = elem.getAttribute( name ); - - // Non-existent attributes return null, we normalize to undefined - return ret === null ? - undefined : - ret; - } - }; -jQuery.attrFix = { "tabindex": 'tabIndex' }; -jQuery.attrFn = { "val": true, -"css": true, -"html": true, -"text": true, -"data": true, -"width": true, -"height": true, -"offset": true, -"blur": true, -"focus": true, -"focusin": true, -"focusout": true, -"load": true, -"resize": true, -"scroll": true, -"unload": true, -"click": true, -"dblclick": true, -"mousedown": true, -"mouseup": true, -"mousemove": true, -"mouseover": true, -"mouseout": true, -"mouseenter": true, -"mouseleave": true, -"change": true, -"select": true, -"submit": true, -"keydown": true, -"keypress": true, -"keyup": true, -"error": true }; -jQuery.attrHooks = { "type": {}, -"value": {}, -"tabIndex": {} }; -jQuery.bindReady = function() { - - if ( readyList ) { - return; - } - - readyList = jQuery._Deferred(); - - // Catch cases where $(document).ready() is called after the - // browser event has already occurred. - if ( document.readyState === "complete" ) { - // Handle it asynchronously to allow scripts the opportunity to delay ready - return setTimeout( jQuery.ready, 1 ); - } - - // Mozilla, Opera and webkit nightlies currently support this event - if ( document.addEventListener ) { - // Use the handy event callback - document.addEventListener( "DOMContentLoaded", DOMContentLoaded, false ); - - // A fallback to window.onload, that will always work - window.addEventListener( "load", jQuery.ready, false ); - - // If IE event model is used - } else if ( document.attachEvent ) { - // ensure firing before onload, - // maybe late but safe also for iframes - document.attachEvent( "onreadystatechange", DOMContentLoaded ); - - // A fallback to window.onload, that will always work - window.attachEvent( "onload", jQuery.ready ); - - // If IE and not a frame - // continually check to see if the document is ready - var toplevel = false; - - try { - toplevel = window.frameElement == null; - } catch(e) {} - - if ( document.documentElement.doScroll && toplevel ) { - doScrollCheck(); - } - } - }; -jQuery.boxModel = true; -jQuery.browser = { "msie": true, -"version": '9.0' }; -jQuery.buildFragment = function( args, nodes, scripts ) { - - var fragment, cacheable, cacheresults, doc; - - // nodes may contain either an explicit document object, - // a jQuery collection or context object. - // If nodes[0] contains a valid object to assign to doc - if ( nodes && nodes[0] ) { - doc = nodes[0].ownerDocument || nodes[0]; - } - - // Ensure that an attr object doesn't incorrectly stand in as a document object - // Chrome and Firefox seem to allow this to occur and will throw exception - // Fixes #8950 - if ( !doc.createDocumentFragment ) { - doc = document; - } - - // Only cache "small" (1/2 KB) HTML strings that are associated with the main document - // Cloning options loses the selected state, so don't cache them - // IE 6 doesn't like it when you put or elements in a fragment - // Also, WebKit does not clone 'checked' attributes on cloneNode, so don't cache - if ( args.length === 1 && typeof args[0] === "string" && args[0].length < 512 && doc === document && - args[0].charAt(0) === "<" && !rnocache.test( args[0] ) && (jQuery.support.checkClone || !rchecked.test( args[0] )) ) { - - cacheable = true; - - cacheresults = jQuery.fragments[ args[0] ]; - if ( cacheresults && cacheresults !== 1 ) { - fragment = cacheresults; - } - } - - if ( !fragment ) { - fragment = doc.createDocumentFragment(); - jQuery.clean( args, doc, fragment, scripts ); - } - - if ( cacheable ) { - jQuery.fragments[ args[0] ] = cacheresults ? fragment : 1; - } - - return { fragment: fragment, cacheable: cacheable }; -}; -jQuery.cache = {}; -jQuery.camelCase = function( string ) { - - return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); - }; -jQuery.clean = function( elems, context, fragment, scripts ) { - - var checkScriptType; - - context = context || document; - - // !context.createElement fails in IE with an error but returns typeof 'object' - if ( typeof context.createElement === "undefined" ) { - context = context.ownerDocument || context[0] && context[0].ownerDocument || document; - } - - var ret = [], j; - - for ( var i = 0, elem; (elem = elems[i]) != null; i++ ) { - if ( typeof elem === "number" ) { - elem += ""; - } - - if ( !elem ) { - continue; - } - - // Convert html string into DOM nodes - if ( typeof elem === "string" ) { - if ( !rhtml.test( elem ) ) { - elem = context.createTextNode( elem ); - } else { - // Fix "XHTML"-style tags in all browsers - elem = elem.replace(rxhtmlTag, "<$1>"); - - // Trim whitespace, otherwise indexOf won't work as expected - var tag = (rtagName.exec( elem ) || ["", ""])[1].toLowerCase(), - wrap = wrapMap[ tag ] || wrapMap._default, - depth = wrap[0], - div = context.createElement("div"); - - // Go to html and back, then peel off extra wrappers - div.innerHTML = wrap[1] + elem + wrap[2]; - - // Move to the right depth - while ( depth-- ) { - div = div.lastChild; - } - - // Remove IE's autoinserted from table fragments - if ( !jQuery.support.tbody ) { - - // String was a , *may* have spurious - var hasBody = rtbody.test(elem), - tbody = tag === "table" && !hasBody ? - div.firstChild && div.firstChild.childNodes : - - // String was a bare or - wrap[1] === "
" && !hasBody ? - div.childNodes : - []; - - for ( j = tbody.length - 1; j >= 0 ; --j ) { - if ( jQuery.nodeName( tbody[ j ], "tbody" ) && !tbody[ j ].childNodes.length ) { - tbody[ j ].parentNode.removeChild( tbody[ j ] ); - } - } - } - - // IE completely kills leading whitespace when innerHTML is used - if ( !jQuery.support.leadingWhitespace && rleadingWhitespace.test( elem ) ) { - div.insertBefore( context.createTextNode( rleadingWhitespace.exec(elem)[0] ), div.firstChild ); - } - - elem = div.childNodes; - } - } - - // Resets defaultChecked for any radios and checkboxes - // about to be appended to the DOM in IE 6/7 (#8060) - var len; - if ( !jQuery.support.appendChecked ) { - if ( elem[0] && typeof (len = elem.length) === "number" ) { - for ( j = 0; j < len; j++ ) { - findInputs( elem[j] ); - } - } else { - findInputs( elem ); - } - } - - if ( elem.nodeType ) { - ret.push( elem ); - } else { - ret = jQuery.merge( ret, elem ); - } - } - - if ( fragment ) { - checkScriptType = function( elem ) { - return !elem.type || rscriptType.test( elem.type ); - }; - for ( i = 0; ret[i]; i++ ) { - if ( scripts && jQuery.nodeName( ret[i], "script" ) && (!ret[i].type || ret[i].type.toLowerCase() === "text/javascript") ) { - scripts.push( ret[i].parentNode ? ret[i].parentNode.removeChild( ret[i] ) : ret[i] ); - - } else { - if ( ret[i].nodeType === 1 ) { - var jsTags = jQuery.grep( ret[i].getElementsByTagName( "script" ), checkScriptType ); - - ret.splice.apply( ret, [i + 1, 0].concat( jsTags ) ); - } - fragment.appendChild( ret[i] ); - } - } - } - - return ret; - }; -jQuery.cleanData = function( elems ) { - - var data, id, cache = jQuery.cache, internalKey = jQuery.expando, special = jQuery.event.special, - deleteExpando = jQuery.support.deleteExpando; - - for ( var i = 0, elem; (elem = elems[i]) != null; i++ ) { - if ( elem.nodeName && jQuery.noData[elem.nodeName.toLowerCase()] ) { - continue; - } - - id = elem[ jQuery.expando ]; - - if ( id ) { - data = cache[ id ] && cache[ id ][ internalKey ]; - - if ( data && data.events ) { - for ( var type in data.events ) { - if ( special[ type ] ) { - jQuery.event.remove( elem, type ); - - // This is a shortcut to avoid jQuery.event.remove's overhead - } else { - jQuery.removeEvent( elem, type, data.handle ); - } - } - - // Null the DOM reference to avoid IE6/7/8 leak (#7054) - if ( data.handle ) { - data.handle.elem = null; - } - } - - if ( deleteExpando ) { - delete elem[ jQuery.expando ]; - - } else if ( elem.removeAttribute ) { - elem.removeAttribute( jQuery.expando ); - } - - delete cache[ id ]; - } - } - }; -jQuery.clone = function( elem, dataAndEvents, deepDataAndEvents ) { - - var clone = elem.cloneNode(true), - srcElements, - destElements, - i; - - if ( (!jQuery.support.noCloneEvent || !jQuery.support.noCloneChecked) && - (elem.nodeType === 1 || elem.nodeType === 11) && !jQuery.isXMLDoc(elem) ) { - // IE copies events bound via attachEvent when using cloneNode. - // Calling detachEvent on the clone will also remove the events - // from the original. In order to get around this, we use some - // proprietary methods to clear the events. Thanks to MooTools - // guys for this hotness. - - cloneFixAttributes( elem, clone ); - - // Using Sizzle here is crazy slow, so we use getElementsByTagName - // instead - srcElements = getAll( elem ); - destElements = getAll( clone ); - - // Weird iteration because IE will replace the length property - // with an element if you are cloning the body and one of the - // elements on the page has a name or id of "length" - for ( i = 0; srcElements[i]; ++i ) { - // Ensure that the destination node is not null; Fixes #9587 - if ( destElements[i] ) { - cloneFixAttributes( srcElements[i], destElements[i] ); - } - } - } - - // Copy the events from the original to the clone - if ( dataAndEvents ) { - cloneCopyEvent( elem, clone ); - - if ( deepDataAndEvents ) { - srcElements = getAll( elem ); - destElements = getAll( clone ); - - for ( i = 0; srcElements[i]; ++i ) { - cloneCopyEvent( srcElements[i], destElements[i] ); - } - } - } - - srcElements = destElements = null; - - // Return the cloned set - return clone; - }; -jQuery.contains = function( a, b ) { -/// -/// Check to see if a DOM element is within another DOM element. -/// -/// -/// The DOM element that may contain the other element. -/// -/// -/// The DOM element that may be contained by the other element. -/// -/// - - return a !== b && (a.contains ? a.contains(b) : true); - }; -jQuery.css = function( elem, name, extra ) { - - var ret, hooks; - - // Make sure that we're working with the right name - name = jQuery.camelCase( name ); - hooks = jQuery.cssHooks[ name ]; - name = jQuery.cssProps[ name ] || name; - - // cssFloat needs a special treatment - if ( name === "cssFloat" ) { - name = "float"; - } - - // If a hook was provided get the computed value from there - if ( hooks && "get" in hooks && (ret = hooks.get( elem, true, extra )) !== undefined ) { - return ret; - - // Otherwise, if a way to get the computed value exists, use that - } else if ( curCSS ) { - return curCSS( elem, name ); - } - }; -jQuery.cssHooks = { "opacity": {}, -"height": {}, -"width": {} }; -jQuery.cssNumber = { "fillOpacity": true, -"fontWeight": true, -"lineHeight": true, -"opacity": true, -"orphans": true, -"widows": true, -"zIndex": true, -"zoom": true }; -jQuery.cssProps = { "float": 'cssFloat' }; -jQuery.curCSS = function( elem, name, extra ) { - - var ret, hooks; - - // Make sure that we're working with the right name - name = jQuery.camelCase( name ); - hooks = jQuery.cssHooks[ name ]; - name = jQuery.cssProps[ name ] || name; - - // cssFloat needs a special treatment - if ( name === "cssFloat" ) { - name = "float"; - } - - // If a hook was provided get the computed value from there - if ( hooks && "get" in hooks && (ret = hooks.get( elem, true, extra )) !== undefined ) { - return ret; - - // Otherwise, if a way to get the computed value exists, use that - } else if ( curCSS ) { - return curCSS( elem, name ); - } - }; -jQuery.data = function( elem, name, data, pvt /* Internal Use Only */ ) { -/// -/// 1: Store arbitrary data associated with the specified element. Returns the value that was set. -/// 1.1 - jQuery.data(element, key, value) -/// 2: Returns value at named data store for the element, as set by jQuery.data(element, name, value), or the full data store for the element. -/// 2.1 - jQuery.data(element, key) -/// 2.2 - jQuery.data(element) -/// -/// -/// The DOM element to associate with the data. -/// -/// -/// A string naming the piece of data to set. -/// -/// -/// The new data value. -/// -/// - - if ( !jQuery.acceptData( elem ) ) { - return; - } - - var thisCache, ret, - internalKey = jQuery.expando, - getByName = typeof name === "string", - - // We have to handle DOM nodes and JS objects differently because IE6-7 - // can't GC object references properly across the DOM-JS boundary - isNode = elem.nodeType, - - // Only DOM nodes need the global jQuery cache; JS object data is - // attached directly to the object so GC can occur automatically - cache = isNode ? jQuery.cache : elem, - - // Only defining an ID for JS objects if its cache already exists allows - // the code to shortcut on the same path as a DOM node with no cache - id = isNode ? elem[ jQuery.expando ] : elem[ jQuery.expando ] && jQuery.expando; - - // Avoid doing any more work than we need to when trying to get data on an - // object that has no data at all - if ( (!id || (pvt && id && (cache[ id ] && !cache[ id ][ internalKey ]))) && getByName && data === undefined ) { - return; - } - - if ( !id ) { - // Only DOM nodes need a new unique ID for each element since their data - // ends up in the global cache - if ( isNode ) { - elem[ jQuery.expando ] = id = ++jQuery.uuid; - } else { - id = jQuery.expando; - } - } - - if ( !cache[ id ] ) { - cache[ id ] = {}; - - // TODO: This is a hack for 1.5 ONLY. Avoids exposing jQuery - // metadata on plain JS objects when the object is serialized using - // JSON.stringify - if ( !isNode ) { - cache[ id ].toJSON = jQuery.noop; - } - } - - // An object can be passed to jQuery.data instead of a key/value pair; this gets - // shallow copied over onto the existing cache - if ( typeof name === "object" || typeof name === "function" ) { - if ( pvt ) { - cache[ id ][ internalKey ] = jQuery.extend(cache[ id ][ internalKey ], name); - } else { - cache[ id ] = jQuery.extend(cache[ id ], name); - } - } - - thisCache = cache[ id ]; - - // Internal jQuery data is stored in a separate object inside the object's data - // cache in order to avoid key collisions between internal data and user-defined - // data - if ( pvt ) { - if ( !thisCache[ internalKey ] ) { - thisCache[ internalKey ] = {}; - } - - thisCache = thisCache[ internalKey ]; - } - - if ( data !== undefined ) { - thisCache[ jQuery.camelCase( name ) ] = data; - } - - // TODO: This is a hack for 1.5 ONLY. It will be removed in 1.6. Users should - // not attempt to inspect the internal events object using jQuery.data, as this - // internal data object is undocumented and subject to change. - if ( name === "events" && !thisCache[name] ) { - return thisCache[ internalKey ] && thisCache[ internalKey ].events; - } - - // Check for both converted-to-camel and non-converted data property names - // If a data property was specified - if ( getByName ) { - - // First Try to find as-is property data - ret = thisCache[ name ]; - - // Test for null|undefined property data - if ( ret == null ) { - - // Try to find the camelCased property - ret = thisCache[ jQuery.camelCase( name ) ]; - } - } else { - ret = thisCache; - } - - return ret; - }; -jQuery.dequeue = function( elem, type ) { -/// -/// Execute the next function on the queue for the matched element. -/// -/// -/// A DOM element from which to remove and execute a queued function. -/// -/// -/// A string containing the name of the queue. Defaults to fx, the standard effects queue. -/// -/// - - type = type || "fx"; - - var queue = jQuery.queue( elem, type ), - fn = queue.shift(), - defer; - - // If the fx queue is dequeued, always remove the progress sentinel - if ( fn === "inprogress" ) { - fn = queue.shift(); - } - - if ( fn ) { - // Add a progress sentinel to prevent the fx queue from being - // automatically dequeued - if ( type === "fx" ) { - queue.unshift("inprogress"); - } - - fn.call(elem, function() { - jQuery.dequeue(elem, type); - }); - } - - if ( !queue.length ) { - jQuery.removeData( elem, type + "queue", true ); - handleQueueMarkDefer( elem, type, "queue" ); - } - }; -jQuery.dir = function( elem, dir, until ) { - - var matched = [], - cur = elem[ dir ]; - - while ( cur && cur.nodeType !== 9 && (until === undefined || cur.nodeType !== 1 || !jQuery( cur ).is( until )) ) { - if ( cur.nodeType === 1 ) { - matched.push( cur ); - } - cur = cur[dir]; - } - return matched; - }; -jQuery.each = function( object, callback, args ) { -/// -/// A generic iterator function, which can be used to seamlessly iterate over both objects and arrays. Arrays and array-like objects with a length property (such as a function's arguments object) are iterated by numeric index, from 0 to length-1. Other objects are iterated via their named properties. -/// -/// -/// The object or array to iterate over. -/// -/// -/// The function that will be executed on every object. -/// -/// - - var name, i = 0, - length = object.length, - isObj = length === undefined || jQuery.isFunction( object ); - - if ( args ) { - if ( isObj ) { - for ( name in object ) { - if ( callback.apply( object[ name ], args ) === false ) { - break; - } - } - } else { - for ( ; i < length; ) { - if ( callback.apply( object[ i++ ], args ) === false ) { - break; - } - } - } - - // A special, fast, case for the most common use of each - } else { - if ( isObj ) { - for ( name in object ) { - if ( callback.call( object[ name ], name, object[ name ] ) === false ) { - break; - } - } - } else { - for ( ; i < length; ) { - if ( callback.call( object[ i ], i, object[ i++ ] ) === false ) { - break; - } - } - } - } - - return object; - }; -jQuery.easing = {}; -jQuery.error = function( msg ) { -/// -/// Takes a string and throws an exception containing it. -/// -/// -/// The message to send out. -/// - - throw msg; - }; -jQuery.etag = {}; -jQuery.event = { "global": {}, -"customEvent": {}, -"props": ['altKey','attrChange','attrName','bubbles','button','cancelable','charCode','clientX','clientY','ctrlKey','currentTarget','data','detail','eventPhase','fromElement','handler','keyCode','layerX','layerY','metaKey','newValue','offsetX','offsetY','pageX','pageY','prevValue','relatedNode','relatedTarget','screenX','screenY','shiftKey','srcElement','target','toElement','view','wheelDelta','which'], -"guid": 100000000, -"special": {}, -"triggered": false}; -jQuery.expr = { "order": ['ID','CLASS','NAME','TAG'], -"match": {}, -"leftMatch": {}, -"attrMap": {}, -"attrHandle": {}, -"relative": {}, -"find": {}, -"preFilter": {}, -"filters": {}, -"setFilters": {}, -"filter": {}, -":": {} }; -jQuery.extend = function() { -/// -/// Merge the contents of two or more objects together into the first object. -/// 1 - jQuery.extend(target, object1, objectN) -/// 2 - jQuery.extend(deep, target, object1, objectN) -/// -/// -/// If true, the merge becomes recursive (aka. deep copy). -/// -/// -/// The object to extend. It will receive the new properties. -/// -/// -/// An object containing additional properties to merge in. -/// -/// -/// Additional objects containing properties to merge in. -/// -/// - - var options, name, src, copy, copyIsArray, clone, - target = arguments[0] || {}, - i = 1, - length = arguments.length, - deep = false; - - // Handle a deep copy situation - if ( typeof target === "boolean" ) { - deep = target; - target = arguments[1] || {}; - // skip the boolean and the target - i = 2; - } - - // Handle case when target is a string or something (possible in deep copy) - if ( typeof target !== "object" && !jQuery.isFunction(target) ) { - target = {}; - } - - // extend jQuery itself if only one argument is passed - if ( length === i ) { - target = this; - --i; - } - - for ( ; i < length; i++ ) { - // Only deal with non-null/undefined values - if ( (options = arguments[ i ]) != null ) { - // Extend the base object - for ( name in options ) { - src = target[ name ]; - copy = options[ name ]; - - // Prevent never-ending loop - if ( target === copy ) { - continue; - } - - // Recurse if we're merging plain objects or arrays - if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) { - if ( copyIsArray ) { - copyIsArray = false; - clone = src && jQuery.isArray(src) ? src : []; - - } else { - clone = src && jQuery.isPlainObject(src) ? src : {}; - } - - // Never move original objects, clone them - target[ name ] = jQuery.extend( deep, clone, copy ); - - // Don't bring in undefined values - } else if ( copy !== undefined ) { - target[ name ] = copy; - } - } - } - } - - // Return the modified object - return target; -}; -jQuery.filter = function( expr, elems, not ) { - - if ( not ) { - expr = ":not(" + expr + ")"; - } - - return elems.length === 1 ? - jQuery.find.matchesSelector(elems[0], expr) ? [ elems[0] ] : [] : - jQuery.find.matches(expr, elems); - }; -jQuery.find = function( query, context, extra, seed ) { - - context = context || document; - - // Only use querySelectorAll on non-XML documents - // (ID selectors don't work in non-HTML documents) - if ( !seed && !Sizzle.isXML(context) ) { - // See if we find a selector to speed up - var match = /^(\w+$)|^\.([\w\-]+$)|^#([\w\-]+$)/.exec( query ); - - if ( match && (context.nodeType === 1 || context.nodeType === 9) ) { - // Speed-up: Sizzle("TAG") - if ( match[1] ) { - return makeArray( context.getElementsByTagName( query ), extra ); - - // Speed-up: Sizzle(".CLASS") - } else if ( match[2] && Expr.find.CLASS && context.getElementsByClassName ) { - return makeArray( context.getElementsByClassName( match[2] ), extra ); - } - } - - if ( context.nodeType === 9 ) { - // Speed-up: Sizzle("body") - // The body element only exists once, optimize finding it - if ( query === "body" && context.body ) { - return makeArray( [ context.body ], extra ); - - // Speed-up: Sizzle("#ID") - } else if ( match && match[3] ) { - var elem = context.getElementById( match[3] ); - - // Check parentNode to catch when Blackberry 4.6 returns - // nodes that are no longer in the document #6963 - if ( elem && elem.parentNode ) { - // Handle the case where IE and Opera return items - // by name instead of ID - if ( elem.id === match[3] ) { - return makeArray( [ elem ], extra ); - } - - } else { - return makeArray( [], extra ); - } - } - - try { - return makeArray( context.querySelectorAll(query), extra ); - } catch(qsaError) {} - - // qSA works strangely on Element-rooted queries - // We can work around this by specifying an extra ID on the root - // and working up from there (Thanks to Andrew Dupont for the technique) - // IE 8 doesn't work on object elements - } else if ( context.nodeType === 1 && context.nodeName.toLowerCase() !== "object" ) { - var oldContext = context, - old = context.getAttribute( "id" ), - nid = old || id, - hasParent = context.parentNode, - relativeHierarchySelector = /^\s*[+~]/.test( query ); - - if ( !old ) { - context.setAttribute( "id", nid ); - } else { - nid = nid.replace( /'/g, "\\$&" ); - } - if ( relativeHierarchySelector && hasParent ) { - context = context.parentNode; - } - - try { - if ( !relativeHierarchySelector || hasParent ) { - return makeArray( context.querySelectorAll( "[id='" + nid + "'] " + query ), extra ); - } - - } catch(pseudoError) { - } finally { - if ( !old ) { - oldContext.removeAttribute( "id" ); - } - } - } - } - - return oldSizzle(query, context, extra, seed); - }; -jQuery.fn = { "selector": '', -"jquery": '1.6.4', -"length": 0 }; -jQuery.fragments = {}; -jQuery.fx = function( elem, options, prop ) { - - this.options = options; - this.elem = elem; - this.prop = prop; - - options.orig = options.orig || {}; - }; -jQuery.get = function( url, data, callback, type ) { -/// -/// Load data from the server using a HTTP GET request. -/// -/// -/// A string containing the URL to which the request is sent. -/// -/// -/// A map or string that is sent to the server with the request. -/// -/// -/// A callback function that is executed if the request succeeds. -/// -/// -/// The type of data expected from the server. Default: Intelligent Guess (xml, json, script, or html). -/// - - // shift arguments if data argument was omitted - if ( jQuery.isFunction( data ) ) { - type = type || callback; - callback = data; - data = undefined; - } - - return jQuery.ajax({ - type: method, - url: url, - data: data, - success: callback, - dataType: type - }); - }; -jQuery.getJSON = function( url, data, callback ) { -/// -/// Load JSON-encoded data from the server using a GET HTTP request. -/// -/// -/// A string containing the URL to which the request is sent. -/// -/// -/// A map or string that is sent to the server with the request. -/// -/// -/// A callback function that is executed if the request succeeds. -/// - - return jQuery.get( url, data, callback, "json" ); - }; -jQuery.getScript = function( url, callback ) { -/// -/// Load a JavaScript file from the server using a GET HTTP request, then execute it. -/// -/// -/// A string containing the URL to which the request is sent. -/// -/// -/// A callback function that is executed if the request succeeds. -/// - - return jQuery.get( url, undefined, callback, "script" ); - }; -jQuery.globalEval = function( data ) { -/// -/// Execute some JavaScript code globally. -/// -/// -/// The JavaScript code to execute. -/// - - if ( data && rnotwhite.test( data ) ) { - // We use execScript on Internet Explorer - // We use an anonymous function so that context is window - // rather than jQuery in Firefox - ( window.execScript || function( data ) { - window[ "eval" ].call( window, data ); - } )( data ); - } - }; -jQuery.grep = function( elems, callback, inv ) { -/// -/// Finds the elements of an array which satisfy a filter function. The original array is not affected. -/// -/// -/// The array to search through. -/// -/// -/// The function to process each item against. The first argument to the function is the item, and the second argument is the index. The function should return a Boolean value. this will be the global window object. -/// -/// -/// If "invert" is false, or not provided, then the function returns an array consisting of all elements for which "callback" returns true. If "invert" is true, then the function returns an array consisting of all elements for which "callback" returns false. -/// -/// - - var ret = [], retVal; - inv = !!inv; - - // Go through the array, only saving the items - // that pass the validator function - for ( var i = 0, length = elems.length; i < length; i++ ) { - retVal = !!callback( elems[ i ], i ); - if ( inv !== retVal ) { - ret.push( elems[ i ] ); - } - } - - return ret; - }; -jQuery.guid = 1; -jQuery.hasData = function( elem ) { -/// -/// Determine whether an element has any jQuery data associated with it. -/// -/// -/// A DOM element to be checked for data. -/// -/// - - elem = elem.nodeType ? jQuery.cache[ elem[jQuery.expando] ] : elem[ jQuery.expando ]; - - return !!elem && !isEmptyDataObject( elem ); - }; -jQuery.holdReady = function( hold ) { -/// -/// Holds or releases the execution of jQuery's ready event. -/// -/// -/// Indicates whether the ready hold is being requested or released -/// -/// - - if ( hold ) { - jQuery.readyWait++; - } else { - jQuery.ready( true ); - } - }; -jQuery.inArray = function( elem, array ) { -/// -/// Search for a specified value within an array and return its index (or -1 if not found). -/// -/// -/// The value to search for. -/// -/// -/// An array through which to search. -/// -/// - - if ( !array ) { - return -1; - } - - if ( indexOf ) { - return indexOf.call( array, elem ); - } - - for ( var i = 0, length = array.length; i < length; i++ ) { - if ( array[ i ] === elem ) { - return i; - } - } - - return -1; - }; -jQuery.isEmptyObject = function( obj ) { -/// -/// Check to see if an object is empty (contains no properties). -/// -/// -/// The object that will be checked to see if it's empty. -/// -/// - - for ( var name in obj ) { - return false; - } - return true; - }; -jQuery.isFunction = function( obj ) { -/// -/// Determine if the argument passed is a Javascript function object. -/// -/// -/// Object to test whether or not it is a function. -/// -/// - - return jQuery.type(obj) === "function"; - }; -jQuery.isNaN = function( obj ) { - - return obj == null || !rdigit.test( obj ) || isNaN( obj ); - }; -jQuery.isPlainObject = function( obj ) { -/// -/// Check to see if an object is a plain object (created using "{}" or "new Object"). -/// -/// -/// The object that will be checked to see if it's a plain object. -/// -/// - - // Must be an Object. - // Because of IE, we also have to check the presence of the constructor property. - // Make sure that DOM nodes and window objects don't pass through, as well - if ( !obj || jQuery.type(obj) !== "object" || obj.nodeType || jQuery.isWindow( obj ) ) { - return false; - } - - try { - // Not own constructor property must be Object - if ( obj.constructor && - !hasOwn.call(obj, "constructor") && - !hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) { - return false; - } - } catch ( e ) { - // IE8,9 Will throw exceptions on certain host objects #9897 - return false; - } - - // Own properties are enumerated firstly, so to speed up, - // if last one is own, then all properties are own. - - var key; - for ( key in obj ) {} - - return key === undefined || hasOwn.call( obj, key ); - }; -jQuery.isReady = true; -jQuery.isWindow = function( obj ) { -/// -/// Determine whether the argument is a window. -/// -/// -/// Object to test whether or not it is a window. -/// -/// - - return obj && typeof obj === "object" && "setInterval" in obj; - }; -jQuery.isXMLDoc = function( elem ) { -/// -/// Check to see if a DOM node is within an XML document (or is an XML document). -/// -/// -/// The DOM node that will be checked to see if it's in an XML document. -/// -/// - - // documentElement is verified for cases where it doesn't yet exist - // (such as loading iframes in IE - #4833) - var documentElement = (elem ? elem.ownerDocument || elem : 0).documentElement; - - return documentElement ? documentElement.nodeName !== "HTML" : false; -}; -jQuery.lastModified = {}; -jQuery.makeArray = function( array, results ) { -/// -/// Convert an array-like object into a true JavaScript array. -/// -/// -/// Any object to turn into a native Array. -/// -/// - - var ret = results || []; - - if ( array != null ) { - // The window, strings (and functions) also have 'length' - // The extra typeof function check is to prevent crashes - // in Safari 2 (See: #3039) - // Tweaked logic slightly to handle Blackberry 4.7 RegExp issues #6930 - var type = jQuery.type( array ); - - if ( array.length == null || type === "string" || type === "function" || type === "regexp" || jQuery.isWindow( array ) ) { - push.call( ret, array ); - } else { - jQuery.merge( ret, array ); - } - } - - return ret; - }; -jQuery.map = function( elems, callback, arg ) { -/// -/// Translate all items in an array or object to new array of items. -/// 1 - jQuery.map(array, callback(elementOfArray, indexInArray)) -/// 2 - jQuery.map(arrayOrObject, callback( value, indexOrKey )) -/// -/// -/// The Array to translate. -/// -/// -/// The function to process each item against. The first argument to the function is the array item, the second argument is the index in array The function can return any value. Within the function, this refers to the global (window) object. -/// -/// - - var value, key, ret = [], - i = 0, - length = elems.length, - // jquery objects are treated as arrays - isArray = elems instanceof jQuery || length !== undefined && typeof length === "number" && ( ( length > 0 && elems[ 0 ] && elems[ length -1 ] ) || length === 0 || jQuery.isArray( elems ) ) ; - - // Go through the array, translating each of the items to their - if ( isArray ) { - for ( ; i < length; i++ ) { - value = callback( elems[ i ], i, arg ); - - if ( value != null ) { - ret[ ret.length ] = value; - } - } - - // Go through every key on the object, - } else { - for ( key in elems ) { - value = callback( elems[ key ], key, arg ); - - if ( value != null ) { - ret[ ret.length ] = value; - } - } - } - - // Flatten any nested arrays - return ret.concat.apply( [], ret ); - }; -jQuery.merge = function( first, second ) { -/// -/// Merge the contents of two arrays together into the first array. -/// -/// -/// The first array to merge, the elements of second added. -/// -/// -/// The second array to merge into the first, unaltered. -/// -/// - - var i = first.length, - j = 0; - - if ( typeof second.length === "number" ) { - for ( var l = second.length; j < l; j++ ) { - first[ i++ ] = second[ j ]; - } - - } else { - while ( second[j] !== undefined ) { - first[ i++ ] = second[ j++ ]; - } - } - - first.length = i; - - return first; - }; -jQuery.noConflict = function( deep ) { -/// -/// Relinquish jQuery's control of the $ variable. -/// -/// -/// A Boolean indicating whether to remove all jQuery variables from the global scope (including jQuery itself). -/// -/// - - if ( window.$ === jQuery ) { - window.$ = _$; - } - - if ( deep && window.jQuery === jQuery ) { - window.jQuery = _jQuery; - } - - return jQuery; - }; -jQuery.noData = { "embed": true, -"object": 'clsid:D27CDB6E-AE6D-11cf-96B8-444553540000', -"applet": true }; -jQuery.nodeName = function( elem, name ) { - - return elem.nodeName && elem.nodeName.toUpperCase() === name.toUpperCase(); - }; -jQuery.noop = function() { -/// -/// An empty function. -/// -/// -}; -jQuery.now = function() { -/// -/// Return a number representing the current time. -/// -/// - - return (new Date()).getTime(); - }; -jQuery.nth = function( cur, result, dir, elem ) { - - result = result || 1; - var num = 0; - - for ( ; cur; cur = cur[dir] ) { - if ( cur.nodeType === 1 && ++num === result ) { - break; - } - } - - return cur; - }; -jQuery.offset = {}; -jQuery.param = function( a, traditional ) { -/// -/// Create a serialized representation of an array or object, suitable for use in a URL query string or Ajax request. -/// 1 - jQuery.param(obj) -/// 2 - jQuery.param(obj, traditional) -/// -/// -/// An array or object to serialize. -/// -/// -/// A Boolean indicating whether to perform a traditional "shallow" serialization. -/// -/// - - var s = [], - add = function( key, value ) { - // If value is a function, invoke it and return its value - value = jQuery.isFunction( value ) ? value() : value; - s[ s.length ] = encodeURIComponent( key ) + "=" + encodeURIComponent( value ); - }; - - // Set traditional to true for jQuery <= 1.3.2 behavior. - if ( traditional === undefined ) { - traditional = jQuery.ajaxSettings.traditional; - } - - // If an array was passed in, assume that it is an array of form elements. - if ( jQuery.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { - // Serialize the form elements - jQuery.each( a, function() { - add( this.name, this.value ); - }); - - } else { - // If traditional, encode the "old" way (the way 1.3.2 or older - // did it), otherwise encode params recursively. - for ( var prefix in a ) { - buildParams( prefix, a[ prefix ], traditional, add ); - } - } - - // Return the resulting serialization - return s.join( "&" ).replace( r20, "+" ); - }; -jQuery.parseJSON = function( data ) { -/// -/// Takes a well-formed JSON string and returns the resulting JavaScript object. -/// -/// -/// The JSON string to parse. -/// -/// - - if ( typeof data !== "string" || !data ) { - return null; - } - - // Make sure leading/trailing whitespace is removed (IE can't handle it) - data = jQuery.trim( data ); - - // Attempt to parse using the native JSON parser first - if ( window.JSON && window.JSON.parse ) { - return window.JSON.parse( data ); - } - - // Make sure the incoming data is actual JSON - // Logic borrowed from http://json.org/json2.js - if ( rvalidchars.test( data.replace( rvalidescape, "@" ) - .replace( rvalidtokens, "]" ) - .replace( rvalidbraces, "")) ) { - - return (new Function( "return " + data ))(); - - } - jQuery.error( "Invalid JSON: " + data ); - }; -jQuery.parseXML = function( data ) { -/// -/// Parses a string into an XML document. -/// -/// -/// a well-formed XML string to be parsed -/// -/// - - var xml, tmp; - try { - if ( window.DOMParser ) { // Standard - tmp = new DOMParser(); - xml = tmp.parseFromString( data , "text/xml" ); - } else { // IE - xml = new ActiveXObject( "Microsoft.XMLDOM" ); - xml.async = "false"; - xml.loadXML( data ); - } - } catch( e ) { - xml = undefined; - } - if ( !xml || !xml.documentElement || xml.getElementsByTagName( "parsererror" ).length ) { - jQuery.error( "Invalid XML: " + data ); - } - return xml; - }; -jQuery.post = function( url, data, callback, type ) { -/// -/// Load data from the server using a HTTP POST request. -/// -/// -/// A string containing the URL to which the request is sent. -/// -/// -/// A map or string that is sent to the server with the request. -/// -/// -/// A callback function that is executed if the request succeeds. -/// -/// -/// The type of data expected from the server. Default: Intelligent Guess (xml, json, script, or html). -/// - - // shift arguments if data argument was omitted - if ( jQuery.isFunction( data ) ) { - type = type || callback; - callback = data; - data = undefined; - } - - return jQuery.ajax({ - type: method, - url: url, - data: data, - success: callback, - dataType: type - }); - }; -jQuery.prop = function( elem, name, value ) { - - var nType = elem.nodeType; - - // don't get/set properties on text, comment and attribute nodes - if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { - return undefined; - } - - var ret, hooks, - notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); - - if ( notxml ) { - // Fix name and attach hooks - name = jQuery.propFix[ name ] || name; - hooks = jQuery.propHooks[ name ]; - } - - if ( value !== undefined ) { - if ( hooks && "set" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ) { - return ret; - - } else { - return (elem[ name ] = value); - } - - } else { - if ( hooks && "get" in hooks && (ret = hooks.get( elem, name )) !== null ) { - return ret; - - } else { - return elem[ name ]; - } - } - }; -jQuery.propFix = { "tabindex": 'tabIndex', -"readonly": 'readOnly', -"for": 'htmlFor', -"class": 'className', -"maxlength": 'maxLength', -"cellspacing": 'cellSpacing', -"cellpadding": 'cellPadding', -"rowspan": 'rowSpan', -"colspan": 'colSpan', -"usemap": 'useMap', -"frameborder": 'frameBorder', -"contenteditable": 'contentEditable' }; -jQuery.propHooks = { "tabIndex": {}, -"selected": {} }; -jQuery.proxy = function( fn, context ) { -/// -/// Takes a function and returns a new one that will always have a particular context. -/// 1 - jQuery.proxy(function, context) -/// 2 - jQuery.proxy(context, name) -/// -/// -/// The function whose context will be changed. -/// -/// -/// The object to which the context (this) of the function should be set. -/// -/// - - if ( typeof context === "string" ) { - var tmp = fn[ context ]; - context = fn; - fn = tmp; - } - - // Quick check to determine if target is callable, in the spec - // this throws a TypeError, but we will just return undefined. - if ( !jQuery.isFunction( fn ) ) { - return undefined; - } - - // Simulated bind - var args = slice.call( arguments, 2 ), - proxy = function() { - return fn.apply( context, args.concat( slice.call( arguments ) ) ); - }; - - // Set the guid of unique handler to the same of original handler, so it can be removed - proxy.guid = fn.guid = fn.guid || proxy.guid || jQuery.guid++; - - return proxy; - }; -jQuery.queue = function( elem, type, data ) { -/// -/// 1: Show the queue of functions to be executed on the matched element. -/// 1.1 - jQuery.queue(element, queueName) -/// 2: Manipulate the queue of functions to be executed on the matched element. -/// 2.1 - jQuery.queue(element, queueName, newQueue) -/// 2.2 - jQuery.queue(element, queueName, callback()) -/// -/// -/// A DOM element where the array of queued functions is attached. -/// -/// -/// A string containing the name of the queue. Defaults to fx, the standard effects queue. -/// -/// -/// An array of functions to replace the current queue contents. -/// -/// - - if ( elem ) { - type = (type || "fx") + "queue"; - var q = jQuery.data( elem, type, undefined, true ); - // Speed up dequeue by getting out quickly if this is just a lookup - if ( data ) { - if ( !q || jQuery.isArray(data) ) { - q = jQuery.data( elem, type, jQuery.makeArray(data), true ); - } else { - q.push( data ); - } - } - return q || []; - } - }; -jQuery.ready = function( wait ) { - - // Either a released hold or an DOMready/load event and not yet ready - if ( (wait === true && !--jQuery.readyWait) || (wait !== true && !jQuery.isReady) ) { - // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). - if ( !document.body ) { - return setTimeout( jQuery.ready, 1 ); - } - - // Remember that the DOM is ready - jQuery.isReady = true; - - // If a normal DOM Ready event fired, decrement, and wait if need be - if ( wait !== true && --jQuery.readyWait > 0 ) { - return; - } - - // If there are functions bound, to execute - readyList.resolveWith( document, [ jQuery ] ); - - // Trigger any bound ready events - if ( jQuery.fn.trigger ) { - jQuery( document ).trigger( "ready" ).unbind( "ready" ); - } - } - }; -jQuery.readyWait = 0; -jQuery.removeAttr = function( elem, name ) { - - var propName; - if ( elem.nodeType === 1 ) { - name = jQuery.attrFix[ name ] || name; - - jQuery.attr( elem, name, "" ); - elem.removeAttribute( name ); - - // Set corresponding property to false for boolean attributes - if ( rboolean.test( name ) && (propName = jQuery.propFix[ name ] || name) in elem ) { - elem[ propName ] = false; - } - } - }; -jQuery.removeData = function( elem, name, pvt /* Internal Use Only */ ) { -/// -/// Remove a previously-stored piece of data. -/// -/// -/// A DOM element from which to remove data. -/// -/// -/// A string naming the piece of data to remove. -/// -/// - - if ( !jQuery.acceptData( elem ) ) { - return; - } - - var thisCache, - - // Reference to internal data cache key - internalKey = jQuery.expando, - - isNode = elem.nodeType, - - // See jQuery.data for more information - cache = isNode ? jQuery.cache : elem, - - // See jQuery.data for more information - id = isNode ? elem[ jQuery.expando ] : jQuery.expando; - - // If there is already no cache entry for this object, there is no - // purpose in continuing - if ( !cache[ id ] ) { - return; - } - - if ( name ) { - - thisCache = pvt ? cache[ id ][ internalKey ] : cache[ id ]; - - if ( thisCache ) { - - // Support interoperable removal of hyphenated or camelcased keys - if ( !thisCache[ name ] ) { - name = jQuery.camelCase( name ); - } - - delete thisCache[ name ]; - - // If there is no data left in the cache, we want to continue - // and let the cache object itself get destroyed - if ( !isEmptyDataObject(thisCache) ) { - return; - } - } - } - - // See jQuery.data for more information - if ( pvt ) { - delete cache[ id ][ internalKey ]; - - // Don't destroy the parent cache unless the internal data object - // had been the only thing left in it - if ( !isEmptyDataObject(cache[ id ]) ) { - return; - } - } - - var internalCache = cache[ id ][ internalKey ]; - - // Browsers that fail expando deletion also refuse to delete expandos on - // the window, but it will allow it on all other JS objects; other browsers - // don't care - // Ensure that `cache` is not a window object #10080 - if ( jQuery.support.deleteExpando || !cache.setInterval ) { - delete cache[ id ]; - } else { - cache[ id ] = null; - } - - // We destroyed the entire user cache at once because it's faster than - // iterating through each key, but we need to continue to persist internal - // data if it existed - if ( internalCache ) { - cache[ id ] = {}; - // TODO: This is a hack for 1.5 ONLY. Avoids exposing jQuery - // metadata on plain JS objects when the object is serialized using - // JSON.stringify - if ( !isNode ) { - cache[ id ].toJSON = jQuery.noop; - } - - cache[ id ][ internalKey ] = internalCache; - - // Otherwise, we need to eliminate the expando on the node to avoid - // false lookups in the cache for entries that no longer exist - } else if ( isNode ) { - // IE does not allow us to delete expando properties from nodes, - // nor does it have a removeAttribute function on Document nodes; - // we must handle all of these cases - if ( jQuery.support.deleteExpando ) { - delete elem[ jQuery.expando ]; - } else if ( elem.removeAttribute ) { - elem.removeAttribute( jQuery.expando ); - } else { - elem[ jQuery.expando ] = null; - } - } - }; -jQuery.removeEvent = function( elem, type, handle ) { - - if ( elem.removeEventListener ) { - elem.removeEventListener( type, handle, false ); - } - }; -jQuery.sibling = function( n, elem ) { - - var r = []; - - for ( ; n; n = n.nextSibling ) { - if ( n.nodeType === 1 && n !== elem ) { - r.push( n ); - } - } - - return r; - }; -jQuery.speed = function( speed, easing, fn ) { - - var opt = speed && typeof speed === "object" ? jQuery.extend({}, speed) : { - complete: fn || !fn && easing || - jQuery.isFunction( speed ) && speed, - duration: speed, - easing: fn && easing || easing && !jQuery.isFunction(easing) && easing - }; - - opt.duration = jQuery.fx.off ? 0 : typeof opt.duration === "number" ? opt.duration : - opt.duration in jQuery.fx.speeds ? jQuery.fx.speeds[opt.duration] : jQuery.fx.speeds._default; - - // Queueing - opt.old = opt.complete; - opt.complete = function( noUnmark ) { - if ( jQuery.isFunction( opt.old ) ) { - opt.old.call( this ); - } - - if ( opt.queue !== false ) { - jQuery.dequeue( this ); - } else if ( noUnmark !== false ) { - jQuery._unmark( this ); - } - }; - - return opt; - }; -jQuery.style = function( elem, name, value, extra ) { - - // Don't set styles on text and comment nodes - if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { - return; - } - - // Make sure that we're working with the right name - var ret, type, origName = jQuery.camelCase( name ), - style = elem.style, hooks = jQuery.cssHooks[ origName ]; - - name = jQuery.cssProps[ origName ] || origName; - - // Check if we're setting a value - if ( value !== undefined ) { - type = typeof value; - - // convert relative number strings (+= or -=) to relative numbers. #7345 - if ( type === "string" && (ret = rrelNum.exec( value )) ) { - value = ( +( ret[1] + 1) * +ret[2] ) + parseFloat( jQuery.css( elem, name ) ); - // Fixes bug #9237 - type = "number"; - } - - // Make sure that NaN and null values aren't set. See: #7116 - if ( value == null || type === "number" && isNaN( value ) ) { - return; - } - - // If a number was passed in, add 'px' to the (except for certain CSS properties) - if ( type === "number" && !jQuery.cssNumber[ origName ] ) { - value += "px"; - } - - // If a hook was provided, use that value, otherwise just set the specified value - if ( !hooks || !("set" in hooks) || (value = hooks.set( elem, value )) !== undefined ) { - // Wrapped to prevent IE from throwing errors when 'invalid' values are provided - // Fixes bug #5509 - try { - style[ name ] = value; - } catch(e) {} - } - - } else { - // If a hook was provided get the non-computed value from there - if ( hooks && "get" in hooks && (ret = hooks.get( elem, false, extra )) !== undefined ) { - return ret; - } - - // Otherwise just get the value from the style object - return style[ name ]; - } - }; -jQuery.sub = function() { -/// -/// Creates a new copy of jQuery whose properties and methods can be modified without affecting the original jQuery object. -/// -/// - - function jQuerySub( selector, context ) { - return new jQuerySub.fn.init( selector, context ); - } - jQuery.extend( true, jQuerySub, this ); - jQuerySub.superclass = this; - jQuerySub.fn = jQuerySub.prototype = this(); - jQuerySub.fn.constructor = jQuerySub; - jQuerySub.sub = this.sub; - jQuerySub.fn.init = function init( selector, context ) { - if ( context && context instanceof jQuery && !(context instanceof jQuerySub) ) { - context = jQuerySub( context ); - } - - return jQuery.fn.init.call( this, selector, context, rootjQuerySub ); - }; - jQuerySub.fn.init.prototype = jQuerySub.fn; - var rootjQuerySub = jQuerySub(document); - return jQuerySub; - }; -jQuery.support = { "leadingWhitespace": true, -"tbody": true, -"htmlSerialize": true, -"style": true, -"hrefNormalized": true, -"opacity": true, -"cssFloat": true, -"checkOn": true, -"optSelected": false, -"getSetAttribute": true, -"submitBubbles": true, -"changeBubbles": true, -"focusinBubbles": true, -"deleteExpando": true, -"noCloneEvent": true, -"inlineBlockNeedsLayout": false, -"shrinkWrapBlocks": false, -"reliableMarginRight": true, -"noCloneChecked": false, -"optDisabled": true, -"radioValue": false, -"checkClone": false, -"appendChecked": true, -"boxModel": true, -"reliableHiddenOffsets": true, -"ajax": true, -"cors": false }; -jQuery.swap = function( elem, options, callback ) { - - var old = {}; - - // Remember the old values, and insert the new ones - for ( var name in options ) { - old[ name ] = elem.style[ name ]; - elem.style[ name ] = options[ name ]; - } - - callback.call( elem ); - - // Revert the old values - for ( name in options ) { - elem.style[ name ] = old[ name ]; - } - }; -jQuery.text = function( elems ) { - - var ret = "", elem; - - for ( var i = 0; elems[i]; i++ ) { - elem = elems[i]; - - // Get the text from text nodes and CDATA nodes - if ( elem.nodeType === 3 || elem.nodeType === 4 ) { - ret += elem.nodeValue; - - // Traverse everything else, except comment nodes - } else if ( elem.nodeType !== 8 ) { - ret += Sizzle.getText( elem.childNodes ); - } - } - - return ret; -}; -jQuery.trim = function( text ) { -/// -/// Remove the whitespace from the beginning and end of a string. -/// -/// -/// The string to trim. -/// -/// - - return text == null ? - "" : - trim.call( text ); - }; -jQuery.type = function( obj ) { -/// -/// Determine the internal JavaScript [[Class]] of an object. -/// -/// -/// Object to get the internal JavaScript [[Class]] of. -/// -/// - - return obj == null ? - String( obj ) : - class2type[ toString.call(obj) ] || "object"; - }; -jQuery.uaMatch = function( ua ) { - - ua = ua.toLowerCase(); - - var match = rwebkit.exec( ua ) || - ropera.exec( ua ) || - rmsie.exec( ua ) || - ua.indexOf("compatible") < 0 && rmozilla.exec( ua ) || - []; - - return { browser: match[1] || "", version: match[2] || "0" }; - }; -jQuery.unique = function( results ) { -/// -/// Sorts an array of DOM elements, in place, with the duplicates removed. Note that this only works on arrays of DOM elements, not strings or numbers. -/// -/// -/// The Array of DOM elements. -/// -/// - - if ( sortOrder ) { - hasDuplicate = baseHasDuplicate; - results.sort( sortOrder ); - - if ( hasDuplicate ) { - for ( var i = 1; i < results.length; i++ ) { - if ( results[i] === results[ i - 1 ] ) { - results.splice( i--, 1 ); - } - } - } - } - - return results; -}; -jQuery.uuid = 0; -jQuery.valHooks = { "option": {}, -"select": {}, -"radio": {}, -"checkbox": {} }; -jQuery.when = function( firstParam ) { -/// -/// Provides a way to execute callback functions based on one or more objects, usually Deferred objects that represent asynchronous events. -/// -/// -/// One or more Deferred objects, or plain JavaScript objects. -/// -/// - - var args = arguments, - i = 0, - length = args.length, - count = length, - deferred = length <= 1 && firstParam && jQuery.isFunction( firstParam.promise ) ? - firstParam : - jQuery.Deferred(); - function resolveFunc( i ) { - return function( value ) { - args[ i ] = arguments.length > 1 ? sliceDeferred.call( arguments, 0 ) : value; - if ( !( --count ) ) { - // Strange bug in FF4: - // Values changed onto the arguments object sometimes end up as undefined values - // outside the $.when method. Cloning the object into a fresh array solves the issue - deferred.resolveWith( deferred, sliceDeferred.call( args, 0 ) ); - } - }; - } - if ( length > 1 ) { - for( ; i < length; i++ ) { - if ( args[ i ] && jQuery.isFunction( args[ i ].promise ) ) { - args[ i ].promise().then( resolveFunc(i), deferred.reject ); - } else { - --count; - } - } - if ( !count ) { - deferred.resolveWith( deferred, args ); - } - } else if ( deferred !== firstParam ) { - deferred.resolveWith( deferred, length ? [ firstParam ] : [] ); - } - return deferred.promise(); - }; -jQuery.Event.prototype.isDefaultPrevented = function returnFalse() { -/// -/// Returns whether event.preventDefault() was ever called on this event object. -/// -/// - - return false; -}; -jQuery.Event.prototype.isImmediatePropagationStopped = function returnFalse() { -/// -/// Returns whether event.stopImmediatePropagation() was ever called on this event object. -/// -/// - - return false; -}; -jQuery.Event.prototype.isPropagationStopped = function returnFalse() { -/// -/// Returns whether event.stopPropagation() was ever called on this event object. -/// -/// - - return false; -}; -jQuery.Event.prototype.preventDefault = function() { -/// -/// If this method is called, the default action of the event will not be triggered. -/// -/// - - this.isDefaultPrevented = returnTrue; - - var e = this.originalEvent; - if ( !e ) { - return; - } - - // if preventDefault exists run it on the original event - if ( e.preventDefault ) { - e.preventDefault(); - - // otherwise set the returnValue property of the original event to false (IE) - } else { - e.returnValue = false; - } - }; -jQuery.Event.prototype.stopImmediatePropagation = function() { -/// -/// Keeps the rest of the handlers from being executed and prevents the event from bubbling up the DOM tree. -/// - - this.isImmediatePropagationStopped = returnTrue; - this.stopPropagation(); - }; -jQuery.Event.prototype.stopPropagation = function() { -/// -/// Prevents the event from bubbling up the DOM tree, preventing any parent handlers from being notified of the event. -/// - - this.isPropagationStopped = returnTrue; - - var e = this.originalEvent; - if ( !e ) { - return; - } - // if stopPropagation exists run it on the original event - if ( e.stopPropagation ) { - e.stopPropagation(); - } - // otherwise set the cancelBubble property of the original event to true (IE) - e.cancelBubble = true; - }; -jQuery.prototype._toggle = function( fn ) { - - // Save reference to arguments for access in closure - var args = arguments, - guid = fn.guid || jQuery.guid++, - i = 0, - toggler = function( event ) { - // Figure out which function to execute - var lastToggle = ( jQuery.data( this, "lastToggle" + fn.guid ) || 0 ) % i; - jQuery.data( this, "lastToggle" + fn.guid, lastToggle + 1 ); - - // Make sure that clicks stop - event.preventDefault(); - - // and execute the function - return args[ lastToggle ].apply( this, arguments ) || false; - }; - - // link all the functions, so any of them can unbind this click handler - toggler.guid = guid; - while ( i < args.length ) { - args[ i++ ].guid = guid; - } - - return this.click( toggler ); - }; -jQuery.prototype.add = function( selector, context ) { -/// -/// Add elements to the set of matched elements. -/// 1 - add(selector) -/// 2 - add(elements) -/// 3 - add(html) -/// 4 - add(jQuery object) -/// 5 - add(selector, context) -/// -/// -/// A string representing a selector expression to find additional elements to add to the set of matched elements. -/// -/// -/// The point in the document at which the selector should begin matching; similar to the context argument of the $(selector, context) method. -/// -/// - - var set = typeof selector === "string" ? - jQuery( selector, context ) : - jQuery.makeArray( selector && selector.nodeType ? [ selector ] : selector ), - all = jQuery.merge( this.get(), set ); - - return this.pushStack( isDisconnected( set[0] ) || isDisconnected( all[0] ) ? - all : - jQuery.unique( all ) ); - }; -jQuery.prototype.addClass = function( value ) { -/// -/// Adds the specified class(es) to each of the set of matched elements. -/// 1 - addClass(className) -/// 2 - addClass(function(index, currentClass)) -/// -/// -/// One or more class names to be added to the class attribute of each matched element. -/// -/// - - var classNames, i, l, elem, - setClass, c, cl; - - if ( jQuery.isFunction( value ) ) { - return this.each(function( j ) { - jQuery( this ).addClass( value.call(this, j, this.className) ); - }); - } - - if ( value && typeof value === "string" ) { - classNames = value.split( rspace ); - - for ( i = 0, l = this.length; i < l; i++ ) { - elem = this[ i ]; - - if ( elem.nodeType === 1 ) { - if ( !elem.className && classNames.length === 1 ) { - elem.className = value; - - } else { - setClass = " " + elem.className + " "; - - for ( c = 0, cl = classNames.length; c < cl; c++ ) { - if ( !~setClass.indexOf( " " + classNames[ c ] + " " ) ) { - setClass += classNames[ c ] + " "; - } - } - elem.className = jQuery.trim( setClass ); - } - } - } - } - - return this; - }; -jQuery.prototype.after = function() { -/// -/// Insert content, specified by the parameter, after each element in the set of matched elements. -/// 1 - after(content, content) -/// 2 - after(function(index)) -/// -/// -/// HTML string, DOM element, or jQuery object to insert after each element in the set of matched elements. -/// -/// -/// One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert after each element in the set of matched elements. -/// -/// - - if ( this[0] && this[0].parentNode ) { - return this.domManip(arguments, false, function( elem ) { - this.parentNode.insertBefore( elem, this.nextSibling ); - }); - } else if ( arguments.length ) { - var set = this.pushStack( this, "after", arguments ); - set.push.apply( set, jQuery(arguments[0]).toArray() ); - return set; - } - }; -jQuery.prototype.ajaxComplete = function( f ){ -/// -/// Register a handler to be called when Ajax requests complete. This is an Ajax Event. -/// -/// -/// The function to be invoked. -/// -/// - - return this.bind( o, f ); - }; -jQuery.prototype.ajaxError = function( f ){ -/// -/// Register a handler to be called when Ajax requests complete with an error. This is an Ajax Event. -/// -/// -/// The function to be invoked. -/// -/// - - return this.bind( o, f ); - }; -jQuery.prototype.ajaxSend = function( f ){ -/// -/// Attach a function to be executed before an Ajax request is sent. This is an Ajax Event. -/// -/// -/// The function to be invoked. -/// -/// - - return this.bind( o, f ); - }; -jQuery.prototype.ajaxStart = function( f ){ -/// -/// Register a handler to be called when the first Ajax request begins. This is an Ajax Event. -/// -/// -/// The function to be invoked. -/// -/// - - return this.bind( o, f ); - }; -jQuery.prototype.ajaxStop = function( f ){ -/// -/// Register a handler to be called when all Ajax requests have completed. This is an Ajax Event. -/// -/// -/// The function to be invoked. -/// -/// - - return this.bind( o, f ); - }; -jQuery.prototype.ajaxSuccess = function( f ){ -/// -/// Attach a function to be executed whenever an Ajax request completes successfully. This is an Ajax Event. -/// -/// -/// The function to be invoked. -/// -/// - - return this.bind( o, f ); - }; -jQuery.prototype.andSelf = function() { -/// -/// Add the previous set of elements on the stack to the current set. -/// -/// - - return this.add( this.prevObject ); - }; -jQuery.prototype.animate = function( prop, speed, easing, callback ) { -/// -/// Perform a custom animation of a set of CSS properties. -/// 1 - animate(properties, duration, easing, complete) -/// 2 - animate(properties, options) -/// -/// -/// A map of CSS properties that the animation will move toward. -/// -/// -/// A string or number determining how long the animation will run. -/// -/// -/// A string indicating which easing function to use for the transition. -/// -/// -/// A function to call once the animation is complete. -/// -/// - - var optall = jQuery.speed(speed, easing, callback); - - if ( jQuery.isEmptyObject( prop ) ) { - return this.each( optall.complete, [ false ] ); - } - - // Do not change referenced properties as per-property easing will be lost - prop = jQuery.extend( {}, prop ); - - return this[ optall.queue === false ? "each" : "queue" ](function() { - // XXX 'this' does not always have a nodeName when running the - // test suite - - if ( optall.queue === false ) { - jQuery._mark( this ); - } - - var opt = jQuery.extend( {}, optall ), - isElement = this.nodeType === 1, - hidden = isElement && jQuery(this).is(":hidden"), - name, val, p, - display, e, - parts, start, end, unit; - - // will store per property easing and be used to determine when an animation is complete - opt.animatedProperties = {}; - - for ( p in prop ) { - - // property name normalization - name = jQuery.camelCase( p ); - if ( p !== name ) { - prop[ name ] = prop[ p ]; - delete prop[ p ]; - } - - val = prop[ name ]; - - // easing resolution: per property > opt.specialEasing > opt.easing > 'swing' (default) - if ( jQuery.isArray( val ) ) { - opt.animatedProperties[ name ] = val[ 1 ]; - val = prop[ name ] = val[ 0 ]; - } else { - opt.animatedProperties[ name ] = opt.specialEasing && opt.specialEasing[ name ] || opt.easing || 'swing'; - } - - if ( val === "hide" && hidden || val === "show" && !hidden ) { - return opt.complete.call( this ); - } - - if ( isElement && ( name === "height" || name === "width" ) ) { - // Make sure that nothing sneaks out - // Record all 3 overflow attributes because IE does not - // change the overflow attribute when overflowX and - // overflowY are set to the same value - opt.overflow = [ this.style.overflow, this.style.overflowX, this.style.overflowY ]; - - // Set display property to inline-block for height/width - // animations on inline elements that are having width/height - // animated - if ( jQuery.css( this, "display" ) === "inline" && - jQuery.css( this, "float" ) === "none" ) { - if ( !jQuery.support.inlineBlockNeedsLayout ) { - this.style.display = "inline-block"; - - } else { - display = defaultDisplay( this.nodeName ); - - // inline-level elements accept inline-block; - // block-level elements need to be inline with layout - if ( display === "inline" ) { - this.style.display = "inline-block"; - - } else { - this.style.display = "inline"; - this.style.zoom = 1; - } - } - } - } - } - - if ( opt.overflow != null ) { - this.style.overflow = "hidden"; - } - - for ( p in prop ) { - e = new jQuery.fx( this, opt, p ); - val = prop[ p ]; - - if ( rfxtypes.test(val) ) { - e[ val === "toggle" ? hidden ? "show" : "hide" : val ](); - - } else { - parts = rfxnum.exec( val ); - start = e.cur(); - - if ( parts ) { - end = parseFloat( parts[2] ); - unit = parts[3] || ( jQuery.cssNumber[ p ] ? "" : "px" ); - - // We need to compute starting value - if ( unit !== "px" ) { - jQuery.style( this, p, (end || 1) + unit); - start = ((end || 1) / e.cur()) * start; - jQuery.style( this, p, start + unit); - } - - // If a +=/-= token was provided, we're doing a relative animation - if ( parts[1] ) { - end = ( (parts[ 1 ] === "-=" ? -1 : 1) * end ) + start; - } - - e.custom( start, end, unit ); - - } else { - e.custom( start, val, "" ); - } - } - } - - // For JS strict compliance - return true; - }); - }; -jQuery.prototype.append = function() { -/// -/// Insert content, specified by the parameter, to the end of each element in the set of matched elements. -/// 1 - append(content, content) -/// 2 - append(function(index, html)) -/// -/// -/// DOM element, HTML string, or jQuery object to insert at the end of each element in the set of matched elements. -/// -/// -/// One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert at the end of each element in the set of matched elements. -/// -/// - - return this.domManip(arguments, true, function( elem ) { - if ( this.nodeType === 1 ) { - this.appendChild( elem ); - } - }); - }; -jQuery.prototype.appendTo = function( selector ) { -/// -/// Insert every element in the set of matched elements to the end of the target. -/// -/// -/// A selector, element, HTML string, or jQuery object; the matched set of elements will be inserted at the end of the element(s) specified by this parameter. -/// -/// - - var ret = [], - insert = jQuery( selector ), - parent = this.length === 1 && this[0].parentNode; - - if ( parent && parent.nodeType === 11 && parent.childNodes.length === 1 && insert.length === 1 ) { - insert[ original ]( this[0] ); - return this; - - } else { - for ( var i = 0, l = insert.length; i < l; i++ ) { - var elems = (i > 0 ? this.clone(true) : this).get(); - jQuery( insert[i] )[ original ]( elems ); - ret = ret.concat( elems ); - } - - return this.pushStack( ret, name, insert.selector ); - } - }; -jQuery.prototype.attr = function( name, value ) { -/// -/// 1: Get the value of an attribute for the first element in the set of matched elements. -/// 1.1 - attr(attributeName) -/// 2: Set one or more attributes for the set of matched elements. -/// 2.1 - attr(attributeName, value) -/// 2.2 - attr(map) -/// 2.3 - attr(attributeName, function(index, attr)) -/// -/// -/// The name of the attribute to set. -/// -/// -/// A value to set for the attribute. -/// -/// - - return jQuery.access( this, name, value, true, jQuery.attr ); - }; -jQuery.prototype.before = function() { -/// -/// Insert content, specified by the parameter, before each element in the set of matched elements. -/// 1 - before(content, content) -/// 2 - before(function) -/// -/// -/// HTML string, DOM element, or jQuery object to insert before each element in the set of matched elements. -/// -/// -/// One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert before each element in the set of matched elements. -/// -/// - - if ( this[0] && this[0].parentNode ) { - return this.domManip(arguments, false, function( elem ) { - this.parentNode.insertBefore( elem, this ); - }); - } else if ( arguments.length ) { - var set = jQuery(arguments[0]); - set.push.apply( set, this.toArray() ); - return this.pushStack( set, "before", arguments ); - } - }; -jQuery.prototype.bind = function( type, data, fn ) { -/// -/// Attach a handler to an event for the elements. -/// 1 - bind(eventType, eventData, handler(eventObject)) -/// 2 - bind(eventType, eventData, preventBubble) -/// 3 - bind(events) -/// -/// -/// A string containing one or more JavaScript event types, such as "click" or "submit," or custom event names. -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - var handler; - - // Handle object literals - if ( typeof type === "object" ) { - for ( var key in type ) { - this[ name ](key, data, type[key], fn); - } - return this; - } - - if ( arguments.length === 2 || data === false ) { - fn = data; - data = undefined; - } - - if ( name === "one" ) { - handler = function( event ) { - jQuery( this ).unbind( event, handler ); - return fn.apply( this, arguments ); - }; - handler.guid = fn.guid || jQuery.guid++; - } else { - handler = fn; - } - - if ( type === "unload" && name !== "one" ) { - this.one( type, data, fn ); - - } else { - for ( var i = 0, l = this.length; i < l; i++ ) { - jQuery.event.add( this[i], type, handler, data ); - } - } - - return this; - }; -jQuery.prototype.blur = function( data, fn ) { -/// -/// Bind an event handler to the "blur" JavaScript event, or trigger that event on an element. -/// 1 - blur(handler(eventObject)) -/// 2 - blur(eventData, handler(eventObject)) -/// 3 - blur() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.change = function( data, fn ) { -/// -/// Bind an event handler to the "change" JavaScript event, or trigger that event on an element. -/// 1 - change(handler(eventObject)) -/// 2 - change(eventData, handler(eventObject)) -/// 3 - change() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.children = function( until, selector ) { -/// -/// Get the children of each element in the set of matched elements, optionally filtered by a selector. -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.clearQueue = function( type ) { -/// -/// Remove from the queue all items that have not yet been run. -/// -/// -/// A string containing the name of the queue. Defaults to fx, the standard effects queue. -/// -/// - - return this.queue( type || "fx", [] ); - }; -jQuery.prototype.click = function( data, fn ) { -/// -/// Bind an event handler to the "click" JavaScript event, or trigger that event on an element. -/// 1 - click(handler(eventObject)) -/// 2 - click(eventData, handler(eventObject)) -/// 3 - click() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.clone = function( dataAndEvents, deepDataAndEvents ) { -/// -/// Create a deep copy of the set of matched elements. -/// 1 - clone(withDataAndEvents) -/// 2 - clone(withDataAndEvents, deepWithDataAndEvents) -/// -/// -/// A Boolean indicating whether event handlers and data should be copied along with the elements. The default value is false. *In jQuery 1.5.0 the default value was incorrectly true; it was changed back to false in 1.5.1 and up. -/// -/// -/// A Boolean indicating whether event handlers and data for all children of the cloned element should be copied. By default its value matches the first argument's value (which defaults to false). -/// -/// - - dataAndEvents = dataAndEvents == null ? false : dataAndEvents; - deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; - - return this.map( function () { - return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); - }); - }; -jQuery.prototype.closest = function( selectors, context ) { -/// -/// 1: Get the first ancestor element that matches the selector, beginning at the current element and progressing up through the DOM tree. -/// 1.1 - closest(selector) -/// 1.2 - closest(selector, context) -/// 1.3 - closest(jQuery object) -/// 1.4 - closest(element) -/// 2: Gets an array of all the elements and selectors matched against the current element up through the DOM tree. -/// 2.1 - closest(selectors, context) -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// -/// A DOM element within which a matching element may be found. If no context is passed in then the context of the jQuery set will be used instead. -/// -/// - - var ret = [], i, l, cur = this[0]; - - // Array - if ( jQuery.isArray( selectors ) ) { - var match, selector, - matches = {}, - level = 1; - - if ( cur && selectors.length ) { - for ( i = 0, l = selectors.length; i < l; i++ ) { - selector = selectors[i]; - - if ( !matches[ selector ] ) { - matches[ selector ] = POS.test( selector ) ? - jQuery( selector, context || this.context ) : - selector; - } - } - - while ( cur && cur.ownerDocument && cur !== context ) { - for ( selector in matches ) { - match = matches[ selector ]; - - if ( match.jquery ? match.index( cur ) > -1 : jQuery( cur ).is( match ) ) { - ret.push({ selector: selector, elem: cur, level: level }); - } - } - - cur = cur.parentNode; - level++; - } - } - - return ret; - } - - // String - var pos = POS.test( selectors ) || typeof selectors !== "string" ? - jQuery( selectors, context || this.context ) : - 0; - - for ( i = 0, l = this.length; i < l; i++ ) { - cur = this[i]; - - while ( cur ) { - if ( pos ? pos.index(cur) > -1 : jQuery.find.matchesSelector(cur, selectors) ) { - ret.push( cur ); - break; - - } else { - cur = cur.parentNode; - if ( !cur || !cur.ownerDocument || cur === context || cur.nodeType === 11 ) { - break; - } - } - } - } - - ret = ret.length > 1 ? jQuery.unique( ret ) : ret; - - return this.pushStack( ret, "closest", selectors ); - }; -jQuery.prototype.constructor = function( selector, context ) { - - // The jQuery object is actually just the init constructor 'enhanced' - return new jQuery.fn.init( selector, context, rootjQuery ); - }; -jQuery.prototype.contents = function( until, selector ) { -/// -/// Get the children of each element in the set of matched elements, including text and comment nodes. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.css = function( name, value ) { -/// -/// 1: Get the value of a style property for the first element in the set of matched elements. -/// 1.1 - css(propertyName) -/// 2: Set one or more CSS properties for the set of matched elements. -/// 2.1 - css(propertyName, value) -/// 2.2 - css(propertyName, function(index, value)) -/// 2.3 - css(map) -/// -/// -/// A CSS property name. -/// -/// -/// A value to set for the property. -/// -/// - - // Setting 'undefined' is a no-op - if ( arguments.length === 2 && value === undefined ) { - return this; - } - - return jQuery.access( this, name, value, true, function( elem, name, value ) { - return value !== undefined ? - jQuery.style( elem, name, value ) : - jQuery.css( elem, name ); - }); -}; -jQuery.prototype.data = function( key, value ) { -/// -/// 1: Store arbitrary data associated with the matched elements. -/// 1.1 - data(key, value) -/// 1.2 - data(obj) -/// 2: Returns value at named data store for the first element in the jQuery collection, as set by data(name, value). -/// 2.1 - data(key) -/// 2.2 - data() -/// -/// -/// A string naming the piece of data to set. -/// -/// -/// The new data value; it can be any Javascript type including Array or Object. -/// -/// - - var data = null; - - if ( typeof key === "undefined" ) { - if ( this.length ) { - data = jQuery.data( this[0] ); - - if ( this[0].nodeType === 1 ) { - var attr = this[0].attributes, name; - for ( var i = 0, l = attr.length; i < l; i++ ) { - name = attr[i].name; - - if ( name.indexOf( "data-" ) === 0 ) { - name = jQuery.camelCase( name.substring(5) ); - - dataAttr( this[0], name, data[ name ] ); - } - } - } - } - - return data; - - } else if ( typeof key === "object" ) { - return this.each(function() { - jQuery.data( this, key ); - }); - } - - var parts = key.split("."); - parts[1] = parts[1] ? "." + parts[1] : ""; - - if ( value === undefined ) { - data = this.triggerHandler("getData" + parts[1] + "!", [parts[0]]); - - // Try to fetch any internally stored data first - if ( data === undefined && this.length ) { - data = jQuery.data( this[0], key ); - data = dataAttr( this[0], key, data ); - } - - return data === undefined && parts[1] ? - this.data( parts[0] ) : - data; - - } else { - return this.each(function() { - var $this = jQuery( this ), - args = [ parts[0], value ]; - - $this.triggerHandler( "setData" + parts[1] + "!", args ); - jQuery.data( this, key, value ); - $this.triggerHandler( "changeData" + parts[1] + "!", args ); - }); - } - }; -jQuery.prototype.dblclick = function( data, fn ) { -/// -/// Bind an event handler to the "dblclick" JavaScript event, or trigger that event on an element. -/// 1 - dblclick(handler(eventObject)) -/// 2 - dblclick(eventData, handler(eventObject)) -/// 3 - dblclick() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.delay = function( time, type ) { -/// -/// Set a timer to delay execution of subsequent items in the queue. -/// -/// -/// An integer indicating the number of milliseconds to delay execution of the next item in the queue. -/// -/// -/// A string containing the name of the queue. Defaults to fx, the standard effects queue. -/// -/// - - time = jQuery.fx ? jQuery.fx.speeds[time] || time : time; - type = type || "fx"; - - return this.queue( type, function() { - var elem = this; - setTimeout(function() { - jQuery.dequeue( elem, type ); - }, time ); - }); - }; -jQuery.prototype.delegate = function( selector, types, data, fn ) { -/// -/// Attach a handler to one or more events for all elements that match the selector, now or in the future, based on a specific set of root elements. -/// 1 - delegate(selector, eventType, handler) -/// 2 - delegate(selector, eventType, eventData, handler) -/// 3 - delegate(selector, events) -/// -/// -/// A selector to filter the elements that trigger the event. -/// -/// -/// A string containing one or more space-separated JavaScript event types, such as "click" or "keydown," or custom event names. -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute at the time the event is triggered. -/// -/// - - return this.live( types, data, fn, selector ); - }; -jQuery.prototype.dequeue = function( type ) { -/// -/// Execute the next function on the queue for the matched elements. -/// -/// -/// A string containing the name of the queue. Defaults to fx, the standard effects queue. -/// -/// - - return this.each(function() { - jQuery.dequeue( this, type ); - }); - }; -jQuery.prototype.detach = function( selector ) { -/// -/// Remove the set of matched elements from the DOM. -/// -/// -/// A selector expression that filters the set of matched elements to be removed. -/// -/// - - return this.remove( selector, true ); - }; -jQuery.prototype.die = function( types, data, fn, origSelector /* Internal Use Only */ ) { -/// -/// 1: Remove all event handlers previously attached using .live() from the elements. -/// 1.1 - die() -/// 2: Remove an event handler previously attached using .live() from the elements. -/// 2.1 - die(eventType, handler) -/// 2.2 - die(eventTypes) -/// -/// -/// A string containing a JavaScript event type, such as click or keydown. -/// -/// -/// The function that is no longer to be executed. -/// -/// - - var type, i = 0, match, namespaces, preType, - selector = origSelector || this.selector, - context = origSelector ? this : jQuery( this.context ); - - if ( typeof types === "object" && !types.preventDefault ) { - for ( var key in types ) { - context[ name ]( key, data, types[key], selector ); - } - - return this; - } - - if ( name === "die" && !types && - origSelector && origSelector.charAt(0) === "." ) { - - context.unbind( origSelector ); - - return this; - } - - if ( data === false || jQuery.isFunction( data ) ) { - fn = data || returnFalse; - data = undefined; - } - - types = (types || "").split(" "); - - while ( (type = types[ i++ ]) != null ) { - match = rnamespaces.exec( type ); - namespaces = ""; - - if ( match ) { - namespaces = match[0]; - type = type.replace( rnamespaces, "" ); - } - - if ( type === "hover" ) { - types.push( "mouseenter" + namespaces, "mouseleave" + namespaces ); - continue; - } - - preType = type; - - if ( liveMap[ type ] ) { - types.push( liveMap[ type ] + namespaces ); - type = type + namespaces; - - } else { - type = (liveMap[ type ] || type) + namespaces; - } - - if ( name === "live" ) { - // bind live handler - for ( var j = 0, l = context.length; j < l; j++ ) { - jQuery.event.add( context[j], "live." + liveConvert( type, selector ), - { data: data, selector: selector, handler: fn, origType: type, origHandler: fn, preType: preType } ); - } - - } else { - // unbind live handler - context.unbind( "live." + liveConvert( type, selector ), fn ); - } - } - - return this; - }; -jQuery.prototype.domManip = function( args, table, callback ) { - - var results, first, fragment, parent, - value = args[0], - scripts = []; - - // We can't cloneNode fragments that contain checked, in WebKit - if ( !jQuery.support.checkClone && arguments.length === 3 && typeof value === "string" && rchecked.test( value ) ) { - return this.each(function() { - jQuery(this).domManip( args, table, callback, true ); - }); - } - - if ( jQuery.isFunction(value) ) { - return this.each(function(i) { - var self = jQuery(this); - args[0] = value.call(this, i, table ? self.html() : undefined); - self.domManip( args, table, callback ); - }); - } - - if ( this[0] ) { - parent = value && value.parentNode; - - // If we're in a fragment, just use that instead of building a new one - if ( jQuery.support.parentNode && parent && parent.nodeType === 11 && parent.childNodes.length === this.length ) { - results = { fragment: parent }; - - } else { - results = jQuery.buildFragment( args, this, scripts ); - } - - fragment = results.fragment; - - if ( fragment.childNodes.length === 1 ) { - first = fragment = fragment.firstChild; - } else { - first = fragment.firstChild; - } - - if ( first ) { - table = table && jQuery.nodeName( first, "tr" ); - - for ( var i = 0, l = this.length, lastIndex = l - 1; i < l; i++ ) { - callback.call( - table ? - root(this[i], first) : - this[i], - // Make sure that we do not leak memory by inadvertently discarding - // the original fragment (which might have attached data) instead of - // using it; in addition, use the original fragment object for the last - // item instead of first because it can end up being emptied incorrectly - // in certain situations (Bug #8070). - // Fragments from the fragment cache must always be cloned and never used - // in place. - results.cacheable || (l > 1 && i < lastIndex) ? - jQuery.clone( fragment, true, true ) : - fragment - ); - } - } - - if ( scripts.length ) { - jQuery.each( scripts, evalScript ); - } - } - - return this; - }; -jQuery.prototype.each = function( callback, args ) { -/// -/// Iterate over a jQuery object, executing a function for each matched element. -/// -/// -/// A function to execute for each matched element. -/// -/// - - return jQuery.each( this, callback, args ); - }; -jQuery.prototype.empty = function() { -/// -/// Remove all child nodes of the set of matched elements from the DOM. -/// -/// - - for ( var i = 0, elem; (elem = this[i]) != null; i++ ) { - // Remove element nodes and prevent memory leaks - if ( elem.nodeType === 1 ) { - jQuery.cleanData( elem.getElementsByTagName("*") ); - } - - // Remove any remaining nodes - while ( elem.firstChild ) { - elem.removeChild( elem.firstChild ); - } - } - - return this; - }; -jQuery.prototype.end = function() { -/// -/// End the most recent filtering operation in the current chain and return the set of matched elements to its previous state. -/// -/// - - return this.prevObject || this.constructor(null); - }; -jQuery.prototype.eq = function( i ) { -/// -/// Reduce the set of matched elements to the one at the specified index. -/// 1 - eq(index) -/// 2 - eq(-index) -/// -/// -/// An integer indicating the 0-based position of the element. -/// -/// - - return i === -1 ? - this.slice( i ) : - this.slice( i, +i + 1 ); - }; -jQuery.prototype.error = function( data, fn ) { -/// -/// Bind an event handler to the "error" JavaScript event. -/// 1 - error(handler(eventObject)) -/// 2 - error(eventData, handler(eventObject)) -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.extend = function() { - - var options, name, src, copy, copyIsArray, clone, - target = arguments[0] || {}, - i = 1, - length = arguments.length, - deep = false; - - // Handle a deep copy situation - if ( typeof target === "boolean" ) { - deep = target; - target = arguments[1] || {}; - // skip the boolean and the target - i = 2; - } - - // Handle case when target is a string or something (possible in deep copy) - if ( typeof target !== "object" && !jQuery.isFunction(target) ) { - target = {}; - } - - // extend jQuery itself if only one argument is passed - if ( length === i ) { - target = this; - --i; - } - - for ( ; i < length; i++ ) { - // Only deal with non-null/undefined values - if ( (options = arguments[ i ]) != null ) { - // Extend the base object - for ( name in options ) { - src = target[ name ]; - copy = options[ name ]; - - // Prevent never-ending loop - if ( target === copy ) { - continue; - } - - // Recurse if we're merging plain objects or arrays - if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) { - if ( copyIsArray ) { - copyIsArray = false; - clone = src && jQuery.isArray(src) ? src : []; - - } else { - clone = src && jQuery.isPlainObject(src) ? src : {}; - } - - // Never move original objects, clone them - target[ name ] = jQuery.extend( deep, clone, copy ); - - // Don't bring in undefined values - } else if ( copy !== undefined ) { - target[ name ] = copy; - } - } - } - } - - // Return the modified object - return target; -}; -jQuery.prototype.fadeIn = function( speed, easing, callback ) { -/// -/// Display the matched elements by fading them to opaque. -/// 1 - fadeIn(duration, callback) -/// 2 - fadeIn(duration, easing, callback) -/// -/// -/// A string or number determining how long the animation will run. -/// -/// -/// A string indicating which easing function to use for the transition. -/// -/// -/// A function to call once the animation is complete. -/// -/// - - return this.animate( props, speed, easing, callback ); - }; -jQuery.prototype.fadeOut = function( speed, easing, callback ) { -/// -/// Hide the matched elements by fading them to transparent. -/// 1 - fadeOut(duration, callback) -/// 2 - fadeOut(duration, easing, callback) -/// -/// -/// A string or number determining how long the animation will run. -/// -/// -/// A string indicating which easing function to use for the transition. -/// -/// -/// A function to call once the animation is complete. -/// -/// - - return this.animate( props, speed, easing, callback ); - }; -jQuery.prototype.fadeTo = function( speed, to, easing, callback ) { -/// -/// Adjust the opacity of the matched elements. -/// 1 - fadeTo(duration, opacity, callback) -/// 2 - fadeTo(duration, opacity, easing, callback) -/// -/// -/// A string or number determining how long the animation will run. -/// -/// -/// A number between 0 and 1 denoting the target opacity. -/// -/// -/// A string indicating which easing function to use for the transition. -/// -/// -/// A function to call once the animation is complete. -/// -/// - - return this.filter(":hidden").css("opacity", 0).show().end() - .animate({opacity: to}, speed, easing, callback); - }; -jQuery.prototype.fadeToggle = function( speed, easing, callback ) { -/// -/// Display or hide the matched elements by animating their opacity. -/// -/// -/// A string or number determining how long the animation will run. -/// -/// -/// A string indicating which easing function to use for the transition. -/// -/// -/// A function to call once the animation is complete. -/// -/// - - return this.animate( props, speed, easing, callback ); - }; -jQuery.prototype.filter = function( selector ) { -/// -/// Reduce the set of matched elements to those that match the selector or pass the function's test. -/// 1 - filter(selector) -/// 2 - filter(function(index)) -/// 3 - filter(element) -/// 4 - filter(jQuery object) -/// -/// -/// A string containing a selector expression to match the current set of elements against. -/// -/// - - return this.pushStack( winnow(this, selector, true), "filter", selector ); - }; -jQuery.prototype.find = function( selector ) { -/// -/// Get the descendants of each element in the current set of matched elements, filtered by a selector, jQuery object, or element. -/// 1 - find(selector) -/// 2 - find(jQuery object) -/// 3 - find(element) -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var self = this, - i, l; - - if ( typeof selector !== "string" ) { - return jQuery( selector ).filter(function() { - for ( i = 0, l = self.length; i < l; i++ ) { - if ( jQuery.contains( self[ i ], this ) ) { - return true; - } - } - }); - } - - var ret = this.pushStack( "", "find", selector ), - length, n, r; - - for ( i = 0, l = this.length; i < l; i++ ) { - length = ret.length; - jQuery.find( selector, this[i], ret ); - - if ( i > 0 ) { - // Make sure that the results are unique - for ( n = length; n < ret.length; n++ ) { - for ( r = 0; r < length; r++ ) { - if ( ret[r] === ret[n] ) { - ret.splice(n--, 1); - break; - } - } - } - } - } - - return ret; - }; -jQuery.prototype.first = function() { -/// -/// Reduce the set of matched elements to the first in the set. -/// -/// - - return this.eq( 0 ); - }; -jQuery.prototype.focus = function( data, fn ) { -/// -/// Bind an event handler to the "focus" JavaScript event, or trigger that event on an element. -/// 1 - focus(handler(eventObject)) -/// 2 - focus(eventData, handler(eventObject)) -/// 3 - focus() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.focusin = function( data, fn ) { -/// -/// Bind an event handler to the "focusin" JavaScript event. -/// 1 - focusin(handler(eventObject)) -/// 2 - focusin(eventData, handler(eventObject)) -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.focusout = function( data, fn ) { -/// -/// Bind an event handler to the "focusout" JavaScript event. -/// 1 - focusout(handler(eventObject)) -/// 2 - focusout(eventData, handler(eventObject)) -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.get = function( num ) { -/// -/// Retrieve the DOM elements matched by the jQuery object. -/// -/// -/// A zero-based integer indicating which element to retrieve. -/// -/// - - return num == null ? - - // Return a 'clean' array - this.toArray() : - - // Return just the object - ( num < 0 ? this[ this.length + num ] : this[ num ] ); - }; -jQuery.prototype.has = function( target ) { -/// -/// Reduce the set of matched elements to those that have a descendant that matches the selector or DOM element. -/// 1 - has(selector) -/// 2 - has(contained) -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var targets = jQuery( target ); - return this.filter(function() { - for ( var i = 0, l = targets.length; i < l; i++ ) { - if ( jQuery.contains( this, targets[i] ) ) { - return true; - } - } - }); - }; -jQuery.prototype.hasClass = function( selector ) { -/// -/// Determine whether any of the matched elements are assigned the given class. -/// -/// -/// The class name to search for. -/// -/// - - var className = " " + selector + " "; - for ( var i = 0, l = this.length; i < l; i++ ) { - if ( this[i].nodeType === 1 && (" " + this[i].className + " ").replace(rclass, " ").indexOf( className ) > -1 ) { - return true; - } - } - - return false; - }; -jQuery.prototype.height = function( size ) { -/// -/// 1: Get the current computed height for the first element in the set of matched elements. -/// 1.1 - height() -/// 2: Set the CSS height of every matched element. -/// 2.1 - height(value) -/// 2.2 - height(function(index, height)) -/// -/// -/// An integer representing the number of pixels, or an integer with an optional unit of measure appended (as a string). -/// -/// - - // Get window width or height - var elem = this[0]; - if ( !elem ) { - return size == null ? null : this; - } - - if ( jQuery.isFunction( size ) ) { - return this.each(function( i ) { - var self = jQuery( this ); - self[ type ]( size.call( this, i, self[ type ]() ) ); - }); - } - - if ( jQuery.isWindow( elem ) ) { - // Everyone else use document.documentElement or document.body depending on Quirks vs Standards mode - // 3rd condition allows Nokia support, as it supports the docElem prop but not CSS1Compat - var docElemProp = elem.document.documentElement[ "client" + name ], - body = elem.document.body; - return elem.document.compatMode === "CSS1Compat" && docElemProp || - body && body[ "client" + name ] || docElemProp; - - // Get document width or height - } else if ( elem.nodeType === 9 ) { - // Either scroll[Width/Height] or offset[Width/Height], whichever is greater - return Math.max( - elem.documentElement["client" + name], - elem.body["scroll" + name], elem.documentElement["scroll" + name], - elem.body["offset" + name], elem.documentElement["offset" + name] - ); - - // Get or set width or height on the element - } else if ( size === undefined ) { - var orig = jQuery.css( elem, type ), - ret = parseFloat( orig ); - - return jQuery.isNaN( ret ) ? orig : ret; - - // Set the width or height on the element (default to pixels if value is unitless) - } else { - return this.css( type, typeof size === "string" ? size : size + "px" ); - } - }; -jQuery.prototype.hide = function( speed, easing, callback ) { -/// -/// Hide the matched elements. -/// 1 - hide() -/// 2 - hide(duration, callback) -/// 3 - hide(duration, easing, callback) -/// -/// -/// A string or number determining how long the animation will run. -/// -/// -/// A string indicating which easing function to use for the transition. -/// -/// -/// A function to call once the animation is complete. -/// -/// - - if ( speed || speed === 0 ) { - return this.animate( genFx("hide", 3), speed, easing, callback); - - } else { - for ( var i = 0, j = this.length; i < j; i++ ) { - if ( this[i].style ) { - var display = jQuery.css( this[i], "display" ); - - if ( display !== "none" && !jQuery._data( this[i], "olddisplay" ) ) { - jQuery._data( this[i], "olddisplay", display ); - } - } - } - - // Set the display of the elements in a second loop - // to avoid the constant reflow - for ( i = 0; i < j; i++ ) { - if ( this[i].style ) { - this[i].style.display = "none"; - } - } - - return this; - } - }; -jQuery.prototype.hover = function( fnOver, fnOut ) { -/// -/// 1: Bind two handlers to the matched elements, to be executed when the mouse pointer enters and leaves the elements. -/// 1.1 - hover(handlerIn(eventObject), handlerOut(eventObject)) -/// 2: Bind a single handler to the matched elements, to be executed when the mouse pointer enters or leaves the elements. -/// 2.1 - hover(handlerInOut(eventObject)) -/// -/// -/// A function to execute when the mouse pointer enters the element. -/// -/// -/// A function to execute when the mouse pointer leaves the element. -/// -/// - - return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver ); - }; -jQuery.prototype.html = function( value ) { -/// -/// 1: Get the HTML contents of the first element in the set of matched elements. -/// 1.1 - html() -/// 2: Set the HTML contents of each element in the set of matched elements. -/// 2.1 - html(htmlString) -/// 2.2 - html(function(index, oldhtml)) -/// -/// -/// A string of HTML to set as the content of each matched element. -/// -/// - - if ( value === undefined ) { - return this[0] && this[0].nodeType === 1 ? - this[0].innerHTML.replace(rinlinejQuery, "") : - null; - - // See if we can take a shortcut and just use innerHTML - } else if ( typeof value === "string" && !rnocache.test( value ) && - (jQuery.support.leadingWhitespace || !rleadingWhitespace.test( value )) && - !wrapMap[ (rtagName.exec( value ) || ["", ""])[1].toLowerCase() ] ) { - - value = value.replace(rxhtmlTag, "<$1>"); - - try { - for ( var i = 0, l = this.length; i < l; i++ ) { - // Remove element nodes and prevent memory leaks - if ( this[i].nodeType === 1 ) { - jQuery.cleanData( this[i].getElementsByTagName("*") ); - this[i].innerHTML = value; - } - } - - // If using innerHTML throws an exception, use the fallback method - } catch(e) { - this.empty().append( value ); - } - - } else if ( jQuery.isFunction( value ) ) { - this.each(function(i){ - var self = jQuery( this ); - - self.html( value.call(this, i, self.html()) ); - }); - - } else { - this.empty().append( value ); - } - - return this; - }; -jQuery.prototype.index = function( elem ) { -/// -/// Search for a given element from among the matched elements. -/// 1 - index() -/// 2 - index(selector) -/// 3 - index(element) -/// -/// -/// A selector representing a jQuery collection in which to look for an element. -/// -/// - - - // No argument, return index in parent - if ( !elem ) { - return ( this[0] && this[0].parentNode ) ? this.prevAll().length : -1; - } - - // index in selector - if ( typeof elem === "string" ) { - return jQuery.inArray( this[0], jQuery( elem ) ); - } - - // Locate the position of the desired element - return jQuery.inArray( - // If it receives a jQuery object, the first element is used - elem.jquery ? elem[0] : elem, this ); - }; -jQuery.prototype.init = function( selector, context, rootjQuery ) { - - var match, elem, ret, doc; - - // Handle $(""), $(null), or $(undefined) - if ( !selector ) { - return this; - } - - // Handle $(DOMElement) - if ( selector.nodeType ) { - this.context = this[0] = selector; - this.length = 1; - return this; - } - - // The body element only exists once, optimize finding it - if ( selector === "body" && !context && document.body ) { - this.context = document; - this[0] = document.body; - this.selector = selector; - this.length = 1; - return this; - } - - // Handle HTML strings - if ( typeof selector === "string" ) { - // Are we dealing with HTML string or an ID? - if ( selector.charAt(0) === "<" && selector.charAt( selector.length - 1 ) === ">" && selector.length >= 3 ) { - // Assume that strings that start and end with <> are HTML and skip the regex check - match = [ null, selector, null ]; - - } else { - match = quickExpr.exec( selector ); - } - - // Verify a match, and that no context was specified for #id - if ( match && (match[1] || !context) ) { - - // HANDLE: $(html) -> $(array) - if ( match[1] ) { - context = context instanceof jQuery ? context[0] : context; - doc = (context ? context.ownerDocument || context : document); - - // If a single string is passed in and it's a single tag - // just do a createElement and skip the rest - ret = rsingleTag.exec( selector ); - - if ( ret ) { - if ( jQuery.isPlainObject( context ) ) { - selector = [ document.createElement( ret[1] ) ]; - jQuery.fn.attr.call( selector, context, true ); - - } else { - selector = [ doc.createElement( ret[1] ) ]; - } - - } else { - ret = jQuery.buildFragment( [ match[1] ], [ doc ] ); - selector = (ret.cacheable ? jQuery.clone(ret.fragment) : ret.fragment).childNodes; - } - - return jQuery.merge( this, selector ); - - // HANDLE: $("#id") - } else { - elem = document.getElementById( match[2] ); - - // Check parentNode to catch when Blackberry 4.6 returns - // nodes that are no longer in the document #6963 - if ( elem && elem.parentNode ) { - // Handle the case where IE and Opera return items - // by name instead of ID - if ( elem.id !== match[2] ) { - return rootjQuery.find( selector ); - } - - // Otherwise, we inject the element directly into the jQuery object - this.length = 1; - this[0] = elem; - } - - this.context = document; - this.selector = selector; - return this; - } - - // HANDLE: $(expr, $(...)) - } else if ( !context || context.jquery ) { - return (context || rootjQuery).find( selector ); - - // HANDLE: $(expr, context) - // (which is just equivalent to: $(context).find(expr) - } else { - return this.constructor( context ).find( selector ); - } - - // HANDLE: $(function) - // Shortcut for document ready - } else if ( jQuery.isFunction( selector ) ) { - return rootjQuery.ready( selector ); - } - - if (selector.selector !== undefined) { - this.selector = selector.selector; - this.context = selector.context; - } - - return jQuery.makeArray( selector, this ); - }; -jQuery.prototype.innerHeight = function() { -/// -/// Get the current computed height for the first element in the set of matched elements, including padding but not border. -/// -/// - - var elem = this[0]; - return elem && elem.style ? - parseFloat( jQuery.css( elem, type, "padding" ) ) : - null; - }; -jQuery.prototype.innerWidth = function() { -/// -/// Get the current computed width for the first element in the set of matched elements, including padding but not border. -/// -/// - - var elem = this[0]; - return elem && elem.style ? - parseFloat( jQuery.css( elem, type, "padding" ) ) : - null; - }; -jQuery.prototype.insertAfter = function( selector ) { -/// -/// Insert every element in the set of matched elements after the target. -/// -/// -/// A selector, element, HTML string, or jQuery object; the matched set of elements will be inserted after the element(s) specified by this parameter. -/// -/// - - var ret = [], - insert = jQuery( selector ), - parent = this.length === 1 && this[0].parentNode; - - if ( parent && parent.nodeType === 11 && parent.childNodes.length === 1 && insert.length === 1 ) { - insert[ original ]( this[0] ); - return this; - - } else { - for ( var i = 0, l = insert.length; i < l; i++ ) { - var elems = (i > 0 ? this.clone(true) : this).get(); - jQuery( insert[i] )[ original ]( elems ); - ret = ret.concat( elems ); - } - - return this.pushStack( ret, name, insert.selector ); - } - }; -jQuery.prototype.insertBefore = function( selector ) { -/// -/// Insert every element in the set of matched elements before the target. -/// -/// -/// A selector, element, HTML string, or jQuery object; the matched set of elements will be inserted before the element(s) specified by this parameter. -/// -/// - - var ret = [], - insert = jQuery( selector ), - parent = this.length === 1 && this[0].parentNode; - - if ( parent && parent.nodeType === 11 && parent.childNodes.length === 1 && insert.length === 1 ) { - insert[ original ]( this[0] ); - return this; - - } else { - for ( var i = 0, l = insert.length; i < l; i++ ) { - var elems = (i > 0 ? this.clone(true) : this).get(); - jQuery( insert[i] )[ original ]( elems ); - ret = ret.concat( elems ); - } - - return this.pushStack( ret, name, insert.selector ); - } - }; -jQuery.prototype.is = function( selector ) { -/// -/// Check the current matched set of elements against a selector, element, or jQuery object and return true if at least one of these elements matches the given arguments. -/// 1 - is(selector) -/// 2 - is(function(index)) -/// 3 - is(jQuery object) -/// 4 - is(element) -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - return !!selector && ( typeof selector === "string" ? - jQuery.filter( selector, this ).length > 0 : - this.filter( selector ).length > 0 ); - }; -jQuery.prototype.keydown = function( data, fn ) { -/// -/// Bind an event handler to the "keydown" JavaScript event, or trigger that event on an element. -/// 1 - keydown(handler(eventObject)) -/// 2 - keydown(eventData, handler(eventObject)) -/// 3 - keydown() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.keypress = function( data, fn ) { -/// -/// Bind an event handler to the "keypress" JavaScript event, or trigger that event on an element. -/// 1 - keypress(handler(eventObject)) -/// 2 - keypress(eventData, handler(eventObject)) -/// 3 - keypress() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.keyup = function( data, fn ) { -/// -/// Bind an event handler to the "keyup" JavaScript event, or trigger that event on an element. -/// 1 - keyup(handler(eventObject)) -/// 2 - keyup(eventData, handler(eventObject)) -/// 3 - keyup() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.last = function() { -/// -/// Reduce the set of matched elements to the final one in the set. -/// -/// - - return this.eq( -1 ); - }; -jQuery.prototype.length = 0; -jQuery.prototype.live = function( types, data, fn, origSelector /* Internal Use Only */ ) { -/// -/// Attach a handler to the event for all elements which match the current selector, now and in the future. -/// 1 - live(eventType, handler) -/// 2 - live(eventType, eventData, handler) -/// 3 - live(events) -/// -/// -/// A string containing a JavaScript event type, such as "click" or "keydown." As of jQuery 1.4 the string can contain multiple, space-separated event types or custom event names, as well. -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute at the time the event is triggered. -/// -/// - - var type, i = 0, match, namespaces, preType, - selector = origSelector || this.selector, - context = origSelector ? this : jQuery( this.context ); - - if ( typeof types === "object" && !types.preventDefault ) { - for ( var key in types ) { - context[ name ]( key, data, types[key], selector ); - } - - return this; - } - - if ( name === "die" && !types && - origSelector && origSelector.charAt(0) === "." ) { - - context.unbind( origSelector ); - - return this; - } - - if ( data === false || jQuery.isFunction( data ) ) { - fn = data || returnFalse; - data = undefined; - } - - types = (types || "").split(" "); - - while ( (type = types[ i++ ]) != null ) { - match = rnamespaces.exec( type ); - namespaces = ""; - - if ( match ) { - namespaces = match[0]; - type = type.replace( rnamespaces, "" ); - } - - if ( type === "hover" ) { - types.push( "mouseenter" + namespaces, "mouseleave" + namespaces ); - continue; - } - - preType = type; - - if ( liveMap[ type ] ) { - types.push( liveMap[ type ] + namespaces ); - type = type + namespaces; - - } else { - type = (liveMap[ type ] || type) + namespaces; - } - - if ( name === "live" ) { - // bind live handler - for ( var j = 0, l = context.length; j < l; j++ ) { - jQuery.event.add( context[j], "live." + liveConvert( type, selector ), - { data: data, selector: selector, handler: fn, origType: type, origHandler: fn, preType: preType } ); - } - - } else { - // unbind live handler - context.unbind( "live." + liveConvert( type, selector ), fn ); - } - } - - return this; - }; -jQuery.prototype.load = function( url, params, callback ) { -/// -/// 1: Bind an event handler to the "load" JavaScript event. -/// 1.1 - load(handler(eventObject)) -/// 1.2 - load(eventData, handler(eventObject)) -/// 2: Load data from the server and place the returned HTML into the matched element. -/// 2.1 - load(url, data, complete(responseText, textStatus, XMLHttpRequest)) -/// -/// -/// A string containing the URL to which the request is sent. -/// -/// -/// A map or string that is sent to the server with the request. -/// -/// -/// A callback function that is executed when the request completes. -/// -/// - - if ( typeof url !== "string" && _load ) { - return _load.apply( this, arguments ); - - // Don't do a request if no elements are being requested - } else if ( !this.length ) { - return this; - } - - var off = url.indexOf( " " ); - if ( off >= 0 ) { - var selector = url.slice( off, url.length ); - url = url.slice( 0, off ); - } - - // Default to a GET request - var type = "GET"; - - // If the second parameter was provided - if ( params ) { - // If it's a function - if ( jQuery.isFunction( params ) ) { - // We assume that it's the callback - callback = params; - params = undefined; - - // Otherwise, build a param string - } else if ( typeof params === "object" ) { - params = jQuery.param( params, jQuery.ajaxSettings.traditional ); - type = "POST"; - } - } - - var self = this; - - // Request the remote document - jQuery.ajax({ - url: url, - type: type, - dataType: "html", - data: params, - // Complete callback (responseText is used internally) - complete: function( jqXHR, status, responseText ) { - // Store the response as specified by the jqXHR object - responseText = jqXHR.responseText; - // If successful, inject the HTML into all the matched elements - if ( jqXHR.isResolved() ) { - // #4825: Get the actual response in case - // a dataFilter is present in ajaxSettings - jqXHR.done(function( r ) { - responseText = r; - }); - // See if a selector was specified - self.html( selector ? - // Create a dummy div to hold the results - jQuery("
") - // inject the contents of the document in, removing the scripts - // to avoid any 'Permission Denied' errors in IE - .append(responseText.replace(rscript, "")) - - // Locate the specified elements - .find(selector) : - - // If not, just inject the full result - responseText ); - } - - if ( callback ) { - self.each( callback, [ responseText, status, jqXHR ] ); - } - } - }); - - return this; - }; -jQuery.prototype.map = function( callback ) { -/// -/// Pass each element in the current matched set through a function, producing a new jQuery object containing the return values. -/// -/// -/// A function object that will be invoked for each element in the current set. -/// -/// - - return this.pushStack( jQuery.map(this, function( elem, i ) { - return callback.call( elem, i, elem ); - })); - }; -jQuery.prototype.mousedown = function( data, fn ) { -/// -/// Bind an event handler to the "mousedown" JavaScript event, or trigger that event on an element. -/// 1 - mousedown(handler(eventObject)) -/// 2 - mousedown(eventData, handler(eventObject)) -/// 3 - mousedown() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.mouseenter = function( data, fn ) { -/// -/// Bind an event handler to be fired when the mouse enters an element, or trigger that handler on an element. -/// 1 - mouseenter(handler(eventObject)) -/// 2 - mouseenter(eventData, handler(eventObject)) -/// 3 - mouseenter() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.mouseleave = function( data, fn ) { -/// -/// Bind an event handler to be fired when the mouse leaves an element, or trigger that handler on an element. -/// 1 - mouseleave(handler(eventObject)) -/// 2 - mouseleave(eventData, handler(eventObject)) -/// 3 - mouseleave() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.mousemove = function( data, fn ) { -/// -/// Bind an event handler to the "mousemove" JavaScript event, or trigger that event on an element. -/// 1 - mousemove(handler(eventObject)) -/// 2 - mousemove(eventData, handler(eventObject)) -/// 3 - mousemove() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.mouseout = function( data, fn ) { -/// -/// Bind an event handler to the "mouseout" JavaScript event, or trigger that event on an element. -/// 1 - mouseout(handler(eventObject)) -/// 2 - mouseout(eventData, handler(eventObject)) -/// 3 - mouseout() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.mouseover = function( data, fn ) { -/// -/// Bind an event handler to the "mouseover" JavaScript event, or trigger that event on an element. -/// 1 - mouseover(handler(eventObject)) -/// 2 - mouseover(eventData, handler(eventObject)) -/// 3 - mouseover() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.mouseup = function( data, fn ) { -/// -/// Bind an event handler to the "mouseup" JavaScript event, or trigger that event on an element. -/// 1 - mouseup(handler(eventObject)) -/// 2 - mouseup(eventData, handler(eventObject)) -/// 3 - mouseup() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.next = function( until, selector ) { -/// -/// Get the immediately following sibling of each element in the set of matched elements. If a selector is provided, it retrieves the next sibling only if it matches that selector. -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.nextAll = function( until, selector ) { -/// -/// Get all following siblings of each element in the set of matched elements, optionally filtered by a selector. -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.nextUntil = function( until, selector ) { -/// -/// Get all following siblings of each element up to but not including the element matched by the selector, DOM node, or jQuery object passed. -/// 1 - nextUntil(selector, filter) -/// 2 - nextUntil(element, filter) -/// -/// -/// A string containing a selector expression to indicate where to stop matching following sibling elements. -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.not = function( selector ) { -/// -/// Remove elements from the set of matched elements. -/// 1 - not(selector) -/// 2 - not(elements) -/// 3 - not(function(index)) -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - return this.pushStack( winnow(this, selector, false), "not", selector); - }; -jQuery.prototype.offset = function( options ) { -/// -/// 1: Get the current coordinates of the first element in the set of matched elements, relative to the document. -/// 1.1 - offset() -/// 2: Set the current coordinates of every element in the set of matched elements, relative to the document. -/// 2.1 - offset(coordinates) -/// 2.2 - offset(function(index, coords)) -/// -/// -/// An object containing the properties top and left, which are integers indicating the new top and left coordinates for the elements. -/// -/// - - var elem = this[0], box; - - if ( options ) { - return this.each(function( i ) { - jQuery.offset.setOffset( this, options, i ); - }); - } - - if ( !elem || !elem.ownerDocument ) { - return null; - } - - if ( elem === elem.ownerDocument.body ) { - return jQuery.offset.bodyOffset( elem ); - } - - try { - box = elem.getBoundingClientRect(); - } catch(e) {} - - var doc = elem.ownerDocument, - docElem = doc.documentElement; - - // Make sure we're not dealing with a disconnected DOM node - if ( !box || !jQuery.contains( docElem, elem ) ) { - return box ? { top: box.top, left: box.left } : { top: 0, left: 0 }; - } - - var body = doc.body, - win = getWindow(doc), - clientTop = docElem.clientTop || body.clientTop || 0, - clientLeft = docElem.clientLeft || body.clientLeft || 0, - scrollTop = win.pageYOffset || jQuery.support.boxModel && docElem.scrollTop || body.scrollTop, - scrollLeft = win.pageXOffset || jQuery.support.boxModel && docElem.scrollLeft || body.scrollLeft, - top = box.top + scrollTop - clientTop, - left = box.left + scrollLeft - clientLeft; - - return { top: top, left: left }; - }; -jQuery.prototype.offsetParent = function() { -/// -/// Get the closest ancestor element that is positioned. -/// -/// - - return this.map(function() { - var offsetParent = this.offsetParent || document.body; - while ( offsetParent && (!rroot.test(offsetParent.nodeName) && jQuery.css(offsetParent, "position") === "static") ) { - offsetParent = offsetParent.offsetParent; - } - return offsetParent; - }); - }; -jQuery.prototype.one = function( type, data, fn ) { -/// -/// Attach a handler to an event for the elements. The handler is executed at most once per element. -/// -/// -/// A string containing one or more JavaScript event types, such as "click" or "submit," or custom event names. -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute at the time the event is triggered. -/// -/// - - var handler; - - // Handle object literals - if ( typeof type === "object" ) { - for ( var key in type ) { - this[ name ](key, data, type[key], fn); - } - return this; - } - - if ( arguments.length === 2 || data === false ) { - fn = data; - data = undefined; - } - - if ( name === "one" ) { - handler = function( event ) { - jQuery( this ).unbind( event, handler ); - return fn.apply( this, arguments ); - }; - handler.guid = fn.guid || jQuery.guid++; - } else { - handler = fn; - } - - if ( type === "unload" && name !== "one" ) { - this.one( type, data, fn ); - - } else { - for ( var i = 0, l = this.length; i < l; i++ ) { - jQuery.event.add( this[i], type, handler, data ); - } - } - - return this; - }; -jQuery.prototype.outerHeight = function( margin ) { -/// -/// Get the current computed height for the first element in the set of matched elements, including padding, border, and optionally margin. -/// -/// -/// A Boolean indicating whether to include the element's margin in the calculation. -/// -/// - - var elem = this[0]; - return elem && elem.style ? - parseFloat( jQuery.css( elem, type, margin ? "margin" : "border" ) ) : - null; - }; -jQuery.prototype.outerWidth = function( margin ) { -/// -/// Get the current computed width for the first element in the set of matched elements, including padding and border. -/// -/// -/// A Boolean indicating whether to include the element's margin in the calculation. -/// -/// - - var elem = this[0]; - return elem && elem.style ? - parseFloat( jQuery.css( elem, type, margin ? "margin" : "border" ) ) : - null; - }; -jQuery.prototype.parent = function( until, selector ) { -/// -/// Get the parent of each element in the current set of matched elements, optionally filtered by a selector. -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.parents = function( until, selector ) { -/// -/// Get the ancestors of each element in the current set of matched elements, optionally filtered by a selector. -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.parentsUntil = function( until, selector ) { -/// -/// Get the ancestors of each element in the current set of matched elements, up to but not including the element matched by the selector, DOM node, or jQuery object. -/// 1 - parentsUntil(selector, filter) -/// 2 - parentsUntil(element, filter) -/// -/// -/// A string containing a selector expression to indicate where to stop matching ancestor elements. -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.position = function() { -/// -/// Get the current coordinates of the first element in the set of matched elements, relative to the offset parent. -/// -/// - - if ( !this[0] ) { - return null; - } - - var elem = this[0], - - // Get *real* offsetParent - offsetParent = this.offsetParent(), - - // Get correct offsets - offset = this.offset(), - parentOffset = rroot.test(offsetParent[0].nodeName) ? { top: 0, left: 0 } : offsetParent.offset(); - - // Subtract element margins - // note: when an element has margin: auto the offsetLeft and marginLeft - // are the same in Safari causing offset.left to incorrectly be 0 - offset.top -= parseFloat( jQuery.css(elem, "marginTop") ) || 0; - offset.left -= parseFloat( jQuery.css(elem, "marginLeft") ) || 0; - - // Add offsetParent borders - parentOffset.top += parseFloat( jQuery.css(offsetParent[0], "borderTopWidth") ) || 0; - parentOffset.left += parseFloat( jQuery.css(offsetParent[0], "borderLeftWidth") ) || 0; - - // Subtract the two offsets - return { - top: offset.top - parentOffset.top, - left: offset.left - parentOffset.left - }; - }; -jQuery.prototype.prepend = function() { -/// -/// Insert content, specified by the parameter, to the beginning of each element in the set of matched elements. -/// 1 - prepend(content, content) -/// 2 - prepend(function(index, html)) -/// -/// -/// DOM element, array of elements, HTML string, or jQuery object to insert at the beginning of each element in the set of matched elements. -/// -/// -/// One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert at the beginning of each element in the set of matched elements. -/// -/// - - return this.domManip(arguments, true, function( elem ) { - if ( this.nodeType === 1 ) { - this.insertBefore( elem, this.firstChild ); - } - }); - }; -jQuery.prototype.prependTo = function( selector ) { -/// -/// Insert every element in the set of matched elements to the beginning of the target. -/// -/// -/// A selector, element, HTML string, or jQuery object; the matched set of elements will be inserted at the beginning of the element(s) specified by this parameter. -/// -/// - - var ret = [], - insert = jQuery( selector ), - parent = this.length === 1 && this[0].parentNode; - - if ( parent && parent.nodeType === 11 && parent.childNodes.length === 1 && insert.length === 1 ) { - insert[ original ]( this[0] ); - return this; - - } else { - for ( var i = 0, l = insert.length; i < l; i++ ) { - var elems = (i > 0 ? this.clone(true) : this).get(); - jQuery( insert[i] )[ original ]( elems ); - ret = ret.concat( elems ); - } - - return this.pushStack( ret, name, insert.selector ); - } - }; -jQuery.prototype.prev = function( until, selector ) { -/// -/// Get the immediately preceding sibling of each element in the set of matched elements, optionally filtered by a selector. -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.prevAll = function( until, selector ) { -/// -/// Get all preceding siblings of each element in the set of matched elements, optionally filtered by a selector. -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.prevUntil = function( until, selector ) { -/// -/// Get all preceding siblings of each element up to but not including the element matched by the selector, DOM node, or jQuery object. -/// 1 - prevUntil(selector, filter) -/// 2 - prevUntil(element, filter) -/// -/// -/// A string containing a selector expression to indicate where to stop matching preceding sibling elements. -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.promise = function( type, object ) { -/// -/// Return a Promise object to observe when all actions of a certain type bound to the collection, queued or not, have finished. -/// -/// -/// The type of queue that needs to be observed. -/// -/// -/// Object onto which the promise methods have to be attached -/// -/// - - if ( typeof type !== "string" ) { - object = type; - type = undefined; - } - type = type || "fx"; - var defer = jQuery.Deferred(), - elements = this, - i = elements.length, - count = 1, - deferDataKey = type + "defer", - queueDataKey = type + "queue", - markDataKey = type + "mark", - tmp; - function resolve() { - if ( !( --count ) ) { - defer.resolveWith( elements, [ elements ] ); - } - } - while( i-- ) { - if (( tmp = jQuery.data( elements[ i ], deferDataKey, undefined, true ) || - ( jQuery.data( elements[ i ], queueDataKey, undefined, true ) || - jQuery.data( elements[ i ], markDataKey, undefined, true ) ) && - jQuery.data( elements[ i ], deferDataKey, jQuery._Deferred(), true ) )) { - count++; - tmp.done( resolve ); - } - } - resolve(); - return defer.promise(); - }; -jQuery.prototype.prop = function( name, value ) { -/// -/// 1: Get the value of a property for the first element in the set of matched elements. -/// 1.1 - prop(propertyName) -/// 2: Set one or more properties for the set of matched elements. -/// 2.1 - prop(propertyName, value) -/// 2.2 - prop(map) -/// 2.3 - prop(propertyName, function(index, oldPropertyValue)) -/// -/// -/// The name of the property to set. -/// -/// -/// A value to set for the property. -/// -/// - - return jQuery.access( this, name, value, true, jQuery.prop ); - }; -jQuery.prototype.pushStack = function( elems, name, selector ) { -/// -/// Add a collection of DOM elements onto the jQuery stack. -/// 1 - pushStack(elements) -/// 2 - pushStack(elements, name, arguments) -/// -/// -/// An array of elements to push onto the stack and make into a new jQuery object. -/// -/// -/// The name of a jQuery method that generated the array of elements. -/// -/// -/// The arguments that were passed in to the jQuery method (for serialization). -/// -/// - - // Build a new jQuery matched element set - var ret = this.constructor(); - - if ( jQuery.isArray( elems ) ) { - push.apply( ret, elems ); - - } else { - jQuery.merge( ret, elems ); - } - - // Add the old object onto the stack (as a reference) - ret.prevObject = this; - - ret.context = this.context; - - if ( name === "find" ) { - ret.selector = this.selector + (this.selector ? " " : "") + selector; - } else if ( name ) { - ret.selector = this.selector + "." + name + "(" + selector + ")"; - } - - // Return the newly-formed element set - return ret; - }; -jQuery.prototype.queue = function( type, data ) { -/// -/// 1: Show the queue of functions to be executed on the matched elements. -/// 1.1 - queue(queueName) -/// 2: Manipulate the queue of functions to be executed on the matched elements. -/// 2.1 - queue(queueName, newQueue) -/// 2.2 - queue(queueName, callback( next )) -/// -/// -/// A string containing the name of the queue. Defaults to fx, the standard effects queue. -/// -/// -/// An array of functions to replace the current queue contents. -/// -/// - - if ( typeof type !== "string" ) { - data = type; - type = "fx"; - } - - if ( data === undefined ) { - return jQuery.queue( this[0], type ); - } - return this.each(function() { - var queue = jQuery.queue( this, type, data ); - - if ( type === "fx" && queue[0] !== "inprogress" ) { - jQuery.dequeue( this, type ); - } - }); - }; -jQuery.prototype.ready = function( fn ) { -/// -/// Specify a function to execute when the DOM is fully loaded. -/// -/// -/// A function to execute after the DOM is ready. -/// -/// - - // Attach the listeners - jQuery.bindReady(); - - // Add the callback - readyList.done( fn ); - - return this; - }; -jQuery.prototype.remove = function( selector, keepData ) { -/// -/// Remove the set of matched elements from the DOM. -/// -/// -/// A selector expression that filters the set of matched elements to be removed. -/// -/// - - for ( var i = 0, elem; (elem = this[i]) != null; i++ ) { - if ( !selector || jQuery.filter( selector, [ elem ] ).length ) { - if ( !keepData && elem.nodeType === 1 ) { - jQuery.cleanData( elem.getElementsByTagName("*") ); - jQuery.cleanData( [ elem ] ); - } - - if ( elem.parentNode ) { - elem.parentNode.removeChild( elem ); - } - } - } - - return this; - }; -jQuery.prototype.removeAttr = function( name ) { -/// -/// Remove an attribute from each element in the set of matched elements. -/// -/// -/// An attribute to remove. -/// -/// - - return this.each(function() { - jQuery.removeAttr( this, name ); - }); - }; -jQuery.prototype.removeClass = function( value ) { -/// -/// Remove a single class, multiple classes, or all classes from each element in the set of matched elements. -/// 1 - removeClass(className) -/// 2 - removeClass(function(index, class)) -/// -/// -/// One or more space-separated classes to be removed from the class attribute of each matched element. -/// -/// - - var classNames, i, l, elem, className, c, cl; - - if ( jQuery.isFunction( value ) ) { - return this.each(function( j ) { - jQuery( this ).removeClass( value.call(this, j, this.className) ); - }); - } - - if ( (value && typeof value === "string") || value === undefined ) { - classNames = (value || "").split( rspace ); - - for ( i = 0, l = this.length; i < l; i++ ) { - elem = this[ i ]; - - if ( elem.nodeType === 1 && elem.className ) { - if ( value ) { - className = (" " + elem.className + " ").replace( rclass, " " ); - for ( c = 0, cl = classNames.length; c < cl; c++ ) { - className = className.replace(" " + classNames[ c ] + " ", " "); - } - elem.className = jQuery.trim( className ); - - } else { - elem.className = ""; - } - } - } - } - - return this; - }; -jQuery.prototype.removeData = function( key ) { -/// -/// Remove a previously-stored piece of data. -/// -/// -/// A string naming the piece of data to delete. -/// -/// - - return this.each(function() { - jQuery.removeData( this, key ); - }); - }; -jQuery.prototype.removeProp = function( name ) { -/// -/// Remove a property for the set of matched elements. -/// -/// -/// The name of the property to set. -/// -/// - - name = jQuery.propFix[ name ] || name; - return this.each(function() { - // try/catch handles cases where IE balks (such as removing a property on window) - try { - this[ name ] = undefined; - delete this[ name ]; - } catch( e ) {} - }); - }; -jQuery.prototype.replaceAll = function( selector ) { -/// -/// Replace each target element with the set of matched elements. -/// -/// -/// A selector expression indicating which element(s) to replace. -/// -/// - - var ret = [], - insert = jQuery( selector ), - parent = this.length === 1 && this[0].parentNode; - - if ( parent && parent.nodeType === 11 && parent.childNodes.length === 1 && insert.length === 1 ) { - insert[ original ]( this[0] ); - return this; - - } else { - for ( var i = 0, l = insert.length; i < l; i++ ) { - var elems = (i > 0 ? this.clone(true) : this).get(); - jQuery( insert[i] )[ original ]( elems ); - ret = ret.concat( elems ); - } - - return this.pushStack( ret, name, insert.selector ); - } - }; -jQuery.prototype.replaceWith = function( value ) { -/// -/// Replace each element in the set of matched elements with the provided new content. -/// 1 - replaceWith(newContent) -/// 2 - replaceWith(function) -/// -/// -/// The content to insert. May be an HTML string, DOM element, or jQuery object. -/// -/// - - if ( this[0] && this[0].parentNode ) { - // Make sure that the elements are removed from the DOM before they are inserted - // this can help fix replacing a parent with child elements - if ( jQuery.isFunction( value ) ) { - return this.each(function(i) { - var self = jQuery(this), old = self.html(); - self.replaceWith( value.call( this, i, old ) ); - }); - } - - if ( typeof value !== "string" ) { - value = jQuery( value ).detach(); - } - - return this.each(function() { - var next = this.nextSibling, - parent = this.parentNode; - - jQuery( this ).remove(); - - if ( next ) { - jQuery(next).before( value ); - } else { - jQuery(parent).append( value ); - } - }); - } else { - return this.length ? - this.pushStack( jQuery(jQuery.isFunction(value) ? value() : value), "replaceWith", value ) : - this; - } - }; -jQuery.prototype.resize = function( data, fn ) { -/// -/// Bind an event handler to the "resize" JavaScript event, or trigger that event on an element. -/// 1 - resize(handler(eventObject)) -/// 2 - resize(eventData, handler(eventObject)) -/// 3 - resize() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.scroll = function( data, fn ) { -/// -/// Bind an event handler to the "scroll" JavaScript event, or trigger that event on an element. -/// 1 - scroll(handler(eventObject)) -/// 2 - scroll(eventData, handler(eventObject)) -/// 3 - scroll() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.scrollLeft = function( val ) { -/// -/// 1: Get the current horizontal position of the scroll bar for the first element in the set of matched elements. -/// 1.1 - scrollLeft() -/// 2: Set the current horizontal position of the scroll bar for each of the set of matched elements. -/// 2.1 - scrollLeft(value) -/// -/// -/// An integer indicating the new position to set the scroll bar to. -/// -/// - - var elem, win; - - if ( val === undefined ) { - elem = this[ 0 ]; - - if ( !elem ) { - return null; - } - - win = getWindow( elem ); - - // Return the scroll offset - return win ? ("pageXOffset" in win) ? win[ i ? "pageYOffset" : "pageXOffset" ] : - jQuery.support.boxModel && win.document.documentElement[ method ] || - win.document.body[ method ] : - elem[ method ]; - } - - // Set the scroll offset - return this.each(function() { - win = getWindow( this ); - - if ( win ) { - win.scrollTo( - !i ? val : jQuery( win ).scrollLeft(), - i ? val : jQuery( win ).scrollTop() - ); - - } else { - this[ method ] = val; - } - }); - }; -jQuery.prototype.scrollTop = function( val ) { -/// -/// 1: Get the current vertical position of the scroll bar for the first element in the set of matched elements. -/// 1.1 - scrollTop() -/// 2: Set the current vertical position of the scroll bar for each of the set of matched elements. -/// 2.1 - scrollTop(value) -/// -/// -/// An integer indicating the new position to set the scroll bar to. -/// -/// - - var elem, win; - - if ( val === undefined ) { - elem = this[ 0 ]; - - if ( !elem ) { - return null; - } - - win = getWindow( elem ); - - // Return the scroll offset - return win ? ("pageXOffset" in win) ? win[ i ? "pageYOffset" : "pageXOffset" ] : - jQuery.support.boxModel && win.document.documentElement[ method ] || - win.document.body[ method ] : - elem[ method ]; - } - - // Set the scroll offset - return this.each(function() { - win = getWindow( this ); - - if ( win ) { - win.scrollTo( - !i ? val : jQuery( win ).scrollLeft(), - i ? val : jQuery( win ).scrollTop() - ); - - } else { - this[ method ] = val; - } - }); - }; -jQuery.prototype.select = function( data, fn ) { -/// -/// Bind an event handler to the "select" JavaScript event, or trigger that event on an element. -/// 1 - select(handler(eventObject)) -/// 2 - select(eventData, handler(eventObject)) -/// 3 - select() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.serialize = function() { -/// -/// Encode a set of form elements as a string for submission. -/// -/// - - return jQuery.param( this.serializeArray() ); - }; -jQuery.prototype.serializeArray = function() { -/// -/// Encode a set of form elements as an array of names and values. -/// -/// - - return this.map(function(){ - return this.elements ? jQuery.makeArray( this.elements ) : this; - }) - .filter(function(){ - return this.name && !this.disabled && - ( this.checked || rselectTextarea.test( this.nodeName ) || - rinput.test( this.type ) ); - }) - .map(function( i, elem ){ - var val = jQuery( this ).val(); - - return val == null ? - null : - jQuery.isArray( val ) ? - jQuery.map( val, function( val, i ){ - return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; - }) : - { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; - }).get(); - }; -jQuery.prototype.show = function( speed, easing, callback ) { -/// -/// Display the matched elements. -/// 1 - show() -/// 2 - show(duration, callback) -/// 3 - show(duration, easing, callback) -/// -/// -/// A string or number determining how long the animation will run. -/// -/// -/// A string indicating which easing function to use for the transition. -/// -/// -/// A function to call once the animation is complete. -/// -/// - - var elem, display; - - if ( speed || speed === 0 ) { - return this.animate( genFx("show", 3), speed, easing, callback); - - } else { - for ( var i = 0, j = this.length; i < j; i++ ) { - elem = this[i]; - - if ( elem.style ) { - display = elem.style.display; - - // Reset the inline display of this element to learn if it is - // being hidden by cascaded rules or not - if ( !jQuery._data(elem, "olddisplay") && display === "none" ) { - display = elem.style.display = ""; - } - - // Set elements which have been overridden with display: none - // in a stylesheet to whatever the default browser style is - // for such an element - if ( display === "" && jQuery.css( elem, "display" ) === "none" ) { - jQuery._data(elem, "olddisplay", defaultDisplay(elem.nodeName)); - } - } - } - - // Set the display of most of the elements in a second loop - // to avoid the constant reflow - for ( i = 0; i < j; i++ ) { - elem = this[i]; - - if ( elem.style ) { - display = elem.style.display; - - if ( display === "" || display === "none" ) { - elem.style.display = jQuery._data(elem, "olddisplay") || ""; - } - } - } - - return this; - } - }; -jQuery.prototype.siblings = function( until, selector ) { -/// -/// Get the siblings of each element in the set of matched elements, optionally filtered by a selector. -/// -/// -/// A string containing a selector expression to match elements against. -/// -/// - - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -jQuery.prototype.size = function() { -/// -/// Return the number of elements in the jQuery object. -/// -/// - - return this.length; - }; -jQuery.prototype.slice = function() { -/// -/// Reduce the set of matched elements to a subset specified by a range of indices. -/// -/// -/// An integer indicating the 0-based position at which the elements begin to be selected. If negative, it indicates an offset from the end of the set. -/// -/// -/// An integer indicating the 0-based position at which the elements stop being selected. If negative, it indicates an offset from the end of the set. If omitted, the range continues until the end of the set. -/// -/// - - return this.pushStack( slice.apply( this, arguments ), - "slice", slice.call(arguments).join(",") ); - }; -jQuery.prototype.slideDown = function( speed, easing, callback ) { -/// -/// Display the matched elements with a sliding motion. -/// 1 - slideDown(duration, callback) -/// 2 - slideDown(duration, easing, callback) -/// -/// -/// A string or number determining how long the animation will run. -/// -/// -/// A string indicating which easing function to use for the transition. -/// -/// -/// A function to call once the animation is complete. -/// -/// - - return this.animate( props, speed, easing, callback ); - }; -jQuery.prototype.slideToggle = function( speed, easing, callback ) { -/// -/// Display or hide the matched elements with a sliding motion. -/// 1 - slideToggle(duration, callback) -/// 2 - slideToggle(duration, easing, callback) -/// -/// -/// A string or number determining how long the animation will run. -/// -/// -/// A string indicating which easing function to use for the transition. -/// -/// -/// A function to call once the animation is complete. -/// -/// - - return this.animate( props, speed, easing, callback ); - }; -jQuery.prototype.slideUp = function( speed, easing, callback ) { -/// -/// Hide the matched elements with a sliding motion. -/// 1 - slideUp(duration, callback) -/// 2 - slideUp(duration, easing, callback) -/// -/// -/// A string or number determining how long the animation will run. -/// -/// -/// A string indicating which easing function to use for the transition. -/// -/// -/// A function to call once the animation is complete. -/// -/// - - return this.animate( props, speed, easing, callback ); - }; -jQuery.prototype.stop = function( clearQueue, gotoEnd ) { -/// -/// Stop the currently-running animation on the matched elements. -/// -/// -/// A Boolean indicating whether to remove queued animation as well. Defaults to false. -/// -/// -/// A Boolean indicating whether to complete the current animation immediately. Defaults to false. -/// -/// - - if ( clearQueue ) { - this.queue([]); - } - - this.each(function() { - var timers = jQuery.timers, - i = timers.length; - // clear marker counters if we know they won't be - if ( !gotoEnd ) { - jQuery._unmark( true, this ); - } - while ( i-- ) { - if ( timers[i].elem === this ) { - if (gotoEnd) { - // force the next step to be the last - timers[i](true); - } - - timers.splice(i, 1); - } - } - }); - - // start the next in the queue if the last step wasn't forced - if ( !gotoEnd ) { - this.dequeue(); - } - - return this; - }; -jQuery.prototype.submit = function( data, fn ) { -/// -/// Bind an event handler to the "submit" JavaScript event, or trigger that event on an element. -/// 1 - submit(handler(eventObject)) -/// 2 - submit(eventData, handler(eventObject)) -/// 3 - submit() -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.text = function( text ) { -/// -/// 1: Get the combined text contents of each element in the set of matched elements, including their descendants. -/// 1.1 - text() -/// 2: Set the content of each element in the set of matched elements to the specified text. -/// 2.1 - text(textString) -/// 2.2 - text(function(index, text)) -/// -/// -/// A string of text to set as the content of each matched element. -/// -/// - - if ( jQuery.isFunction(text) ) { - return this.each(function(i) { - var self = jQuery( this ); - - self.text( text.call(this, i, self.text()) ); - }); - } - - if ( typeof text !== "object" && text !== undefined ) { - return this.empty().append( (this[0] && this[0].ownerDocument || document).createTextNode( text ) ); - } - - return jQuery.text( this ); - }; -jQuery.prototype.toArray = function() { -/// -/// Retrieve all the DOM elements contained in the jQuery set, as an array. -/// -/// - - return slice.call( this, 0 ); - }; -jQuery.prototype.toggle = function( fn, fn2, callback ) { -/// -/// 1: Bind two or more handlers to the matched elements, to be executed on alternate clicks. -/// 1.1 - toggle(handler(eventObject), handler(eventObject), handler(eventObject)) -/// 2: Display or hide the matched elements. -/// 2.1 - toggle(duration, callback) -/// 2.2 - toggle(duration, easing, callback) -/// 2.3 - toggle(showOrHide) -/// -/// -/// A function to execute every even time the element is clicked. -/// -/// -/// A function to execute every odd time the element is clicked. -/// -/// -/// Additional handlers to cycle through after clicks. -/// -/// - - var bool = typeof fn === "boolean"; - - if ( jQuery.isFunction(fn) && jQuery.isFunction(fn2) ) { - this._toggle.apply( this, arguments ); - - } else if ( fn == null || bool ) { - this.each(function() { - var state = bool ? fn : jQuery(this).is(":hidden"); - jQuery(this)[ state ? "show" : "hide" ](); - }); - - } else { - this.animate(genFx("toggle", 3), fn, fn2, callback); - } - - return this; - }; -jQuery.prototype.toggleClass = function( value, stateVal ) { -/// -/// Add or remove one or more classes from each element in the set of matched elements, depending on either the class's presence or the value of the switch argument. -/// 1 - toggleClass(className) -/// 2 - toggleClass(className, switch) -/// 3 - toggleClass(switch) -/// 4 - toggleClass(function(index, class, switch), switch) -/// -/// -/// One or more class names (separated by spaces) to be toggled for each element in the matched set. -/// -/// -/// A Boolean (not just truthy/falsy) value to determine whether the class should be added or removed. -/// -/// - - var type = typeof value, - isBool = typeof stateVal === "boolean"; - - if ( jQuery.isFunction( value ) ) { - return this.each(function( i ) { - jQuery( this ).toggleClass( value.call(this, i, this.className, stateVal), stateVal ); - }); - } - - return this.each(function() { - if ( type === "string" ) { - // toggle individual class names - var className, - i = 0, - self = jQuery( this ), - state = stateVal, - classNames = value.split( rspace ); - - while ( (className = classNames[ i++ ]) ) { - // check each className given, space seperated list - state = isBool ? state : !self.hasClass( className ); - self[ state ? "addClass" : "removeClass" ]( className ); - } - - } else if ( type === "undefined" || type === "boolean" ) { - if ( this.className ) { - // store className if set - jQuery._data( this, "__className__", this.className ); - } - - // toggle whole className - this.className = this.className || value === false ? "" : jQuery._data( this, "__className__" ) || ""; - } - }); - }; -jQuery.prototype.trigger = function( type, data ) { -/// -/// Execute all handlers and behaviors attached to the matched elements for the given event type. -/// 1 - trigger(eventType, extraParameters) -/// 2 - trigger(event) -/// -/// -/// A string containing a JavaScript event type, such as click or submit. -/// -/// -/// Additional parameters to pass along to the event handler. -/// -/// - - return this.each(function() { - jQuery.event.trigger( type, data, this ); - }); - }; -jQuery.prototype.triggerHandler = function( type, data ) { -/// -/// Execute all handlers attached to an element for an event. -/// -/// -/// A string containing a JavaScript event type, such as click or submit. -/// -/// -/// An array of additional parameters to pass along to the event handler. -/// -/// - - if ( this[0] ) { - return jQuery.event.trigger( type, data, this[0], true ); - } - }; -jQuery.prototype.unbind = function( type, fn ) { -/// -/// Remove a previously-attached event handler from the elements. -/// 1 - unbind(eventType, handler(eventObject)) -/// 2 - unbind(eventType, false) -/// 3 - unbind(event) -/// -/// -/// A string containing a JavaScript event type, such as click or submit. -/// -/// -/// The function that is to be no longer executed. -/// -/// - - // Handle object literals - if ( typeof type === "object" && !type.preventDefault ) { - for ( var key in type ) { - this.unbind(key, type[key]); - } - - } else { - for ( var i = 0, l = this.length; i < l; i++ ) { - jQuery.event.remove( this[i], type, fn ); - } - } - - return this; - }; -jQuery.prototype.undelegate = function( selector, types, fn ) { -/// -/// Remove a handler from the event for all elements which match the current selector, now or in the future, based upon a specific set of root elements. -/// 1 - undelegate() -/// 2 - undelegate(selector, eventType) -/// 3 - undelegate(selector, eventType, handler) -/// 4 - undelegate(selector, events) -/// 5 - undelegate(namespace) -/// -/// -/// A selector which will be used to filter the event results. -/// -/// -/// A string containing a JavaScript event type, such as "click" or "keydown" -/// -/// -/// A function to execute at the time the event is triggered. -/// -/// - - if ( arguments.length === 0 ) { - return this.unbind( "live" ); - - } else { - return this.die( types, null, fn, selector ); - } - }; -jQuery.prototype.unload = function( data, fn ) { -/// -/// Bind an event handler to the "unload" JavaScript event. -/// 1 - unload(handler(eventObject)) -/// 2 - unload(eventData, handler(eventObject)) -/// -/// -/// A map of data that will be passed to the event handler. -/// -/// -/// A function to execute each time the event is triggered. -/// -/// - - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; -jQuery.prototype.unwrap = function() { -/// -/// Remove the parents of the set of matched elements from the DOM, leaving the matched elements in their place. -/// -/// - - return this.parent().each(function() { - if ( !jQuery.nodeName( this, "body" ) ) { - jQuery( this ).replaceWith( this.childNodes ); - } - }).end(); - }; -jQuery.prototype.val = function( value ) { -/// -/// 1: Get the current value of the first element in the set of matched elements. -/// 1.1 - val() -/// 2: Set the value of each element in the set of matched elements. -/// 2.1 - val(value) -/// 2.2 - val(function(index, value)) -/// -/// -/// A string of text or an array of strings corresponding to the value of each matched element to set as selected/checked. -/// -/// - - var hooks, ret, - elem = this[0]; - - if ( !arguments.length ) { - if ( elem ) { - hooks = jQuery.valHooks[ elem.nodeName.toLowerCase() ] || jQuery.valHooks[ elem.type ]; - - if ( hooks && "get" in hooks && (ret = hooks.get( elem, "value" )) !== undefined ) { - return ret; - } - - ret = elem.value; - - return typeof ret === "string" ? - // handle most common string cases - ret.replace(rreturn, "") : - // handle cases where value is null/undef or number - ret == null ? "" : ret; - } - - return undefined; - } - - var isFunction = jQuery.isFunction( value ); - - return this.each(function( i ) { - var self = jQuery(this), val; - - if ( this.nodeType !== 1 ) { - return; - } - - if ( isFunction ) { - val = value.call( this, i, self.val() ); - } else { - val = value; - } - - // Treat null/undefined as ""; convert numbers to string - if ( val == null ) { - val = ""; - } else if ( typeof val === "number" ) { - val += ""; - } else if ( jQuery.isArray( val ) ) { - val = jQuery.map(val, function ( value ) { - return value == null ? "" : value + ""; - }); - } - - hooks = jQuery.valHooks[ this.nodeName.toLowerCase() ] || jQuery.valHooks[ this.type ]; - - // If set returns undefined, fall back to normal setting - if ( !hooks || !("set" in hooks) || hooks.set( this, val, "value" ) === undefined ) { - this.value = val; - } - }); - }; -jQuery.prototype.width = function( size ) { -/// -/// 1: Get the current computed width for the first element in the set of matched elements. -/// 1.1 - width() -/// 2: Set the CSS width of each element in the set of matched elements. -/// 2.1 - width(value) -/// 2.2 - width(function(index, width)) -/// -/// -/// An integer representing the number of pixels, or an integer along with an optional unit of measure appended (as a string). -/// -/// - - // Get window width or height - var elem = this[0]; - if ( !elem ) { - return size == null ? null : this; - } - - if ( jQuery.isFunction( size ) ) { - return this.each(function( i ) { - var self = jQuery( this ); - self[ type ]( size.call( this, i, self[ type ]() ) ); - }); - } - - if ( jQuery.isWindow( elem ) ) { - // Everyone else use document.documentElement or document.body depending on Quirks vs Standards mode - // 3rd condition allows Nokia support, as it supports the docElem prop but not CSS1Compat - var docElemProp = elem.document.documentElement[ "client" + name ], - body = elem.document.body; - return elem.document.compatMode === "CSS1Compat" && docElemProp || - body && body[ "client" + name ] || docElemProp; - - // Get document width or height - } else if ( elem.nodeType === 9 ) { - // Either scroll[Width/Height] or offset[Width/Height], whichever is greater - return Math.max( - elem.documentElement["client" + name], - elem.body["scroll" + name], elem.documentElement["scroll" + name], - elem.body["offset" + name], elem.documentElement["offset" + name] - ); - - // Get or set width or height on the element - } else if ( size === undefined ) { - var orig = jQuery.css( elem, type ), - ret = parseFloat( orig ); - - return jQuery.isNaN( ret ) ? orig : ret; - - // Set the width or height on the element (default to pixels if value is unitless) - } else { - return this.css( type, typeof size === "string" ? size : size + "px" ); - } - }; -jQuery.prototype.wrap = function( html ) { -/// -/// Wrap an HTML structure around each element in the set of matched elements. -/// 1 - wrap(wrappingElement) -/// 2 - wrap(function(index)) -/// -/// -/// An HTML snippet, selector expression, jQuery object, or DOM element specifying the structure to wrap around the matched elements. -/// -/// - - return this.each(function() { - jQuery( this ).wrapAll( html ); - }); - }; -jQuery.prototype.wrapAll = function( html ) { -/// -/// Wrap an HTML structure around all elements in the set of matched elements. -/// -/// -/// An HTML snippet, selector expression, jQuery object, or DOM element specifying the structure to wrap around the matched elements. -/// -/// - - if ( jQuery.isFunction( html ) ) { - return this.each(function(i) { - jQuery(this).wrapAll( html.call(this, i) ); - }); - } - - if ( this[0] ) { - // The elements to wrap the target around - var wrap = jQuery( html, this[0].ownerDocument ).eq(0).clone(true); - - if ( this[0].parentNode ) { - wrap.insertBefore( this[0] ); - } - - wrap.map(function() { - var elem = this; - - while ( elem.firstChild && elem.firstChild.nodeType === 1 ) { - elem = elem.firstChild; - } - - return elem; - }).append( this ); - } - - return this; - }; -jQuery.prototype.wrapInner = function( html ) { -/// -/// Wrap an HTML structure around the content of each element in the set of matched elements. -/// 1 - wrapInner(wrappingElement) -/// 2 - wrapInner(function(index)) -/// -/// -/// An HTML snippet, selector expression, jQuery object, or DOM element specifying the structure to wrap around the content of the matched elements. -/// -/// - - if ( jQuery.isFunction( html ) ) { - return this.each(function(i) { - jQuery(this).wrapInner( html.call(this, i) ); - }); - } - - return this.each(function() { - var self = jQuery( this ), - contents = self.contents(); - - if ( contents.length ) { - contents.wrapAll( html ); - - } else { - self.append( html ); - } - }); - }; -jQuery.fn = jQuery.prototype; -jQuery.fn.init.prototype = jQuery.fn; -window.jQuery = window.$ = jQuery; -})(window); \ No newline at end of file diff --git a/Scripts/jquery-1.6.4.js b/Scripts/jquery-1.6.4.js deleted file mode 100644 index 11e6d0679..000000000 --- a/Scripts/jquery-1.6.4.js +++ /dev/null @@ -1,9046 +0,0 @@ -/*! - * jQuery JavaScript Library v1.6.4 - * http://jquery.com/ - * - * Copyright 2011, John Resig - * Dual licensed under the MIT or GPL Version 2 licenses. - * http://jquery.org/license - * - * Includes Sizzle.js - * http://sizzlejs.com/ - * Copyright 2011, The Dojo Foundation - * Released under the MIT, BSD, and GPL Licenses. - * - * Date: Mon Sep 12 18:54:48 2011 -0400 - */ -(function( window, undefined ) { - -// Use the correct document accordingly with window argument (sandbox) -var document = window.document, - navigator = window.navigator, - location = window.location; -var jQuery = (function() { - -// Define a local copy of jQuery -var jQuery = function( selector, context ) { - // The jQuery object is actually just the init constructor 'enhanced' - return new jQuery.fn.init( selector, context, rootjQuery ); - }, - - // Map over jQuery in case of overwrite - _jQuery = window.jQuery, - - // Map over the $ in case of overwrite - _$ = window.$, - - // A central reference to the root jQuery(document) - rootjQuery, - - // A simple way to check for HTML strings or ID strings - // Prioritize #id over to avoid XSS via location.hash (#9521) - quickExpr = /^(?:[^#<]*(<[\w\W]+>)[^>]*$|#([\w\-]*)$)/, - - // Check if a string has a non-whitespace character in it - rnotwhite = /\S/, - - // Used for trimming whitespace - trimLeft = /^\s+/, - trimRight = /\s+$/, - - // Check for digits - rdigit = /\d/, - - // Match a standalone tag - rsingleTag = /^<(\w+)\s*\/?>(?:<\/\1>)?$/, - - // JSON RegExp - rvalidchars = /^[\],:{}\s]*$/, - rvalidescape = /\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, - rvalidtokens = /"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, - rvalidbraces = /(?:^|:|,)(?:\s*\[)+/g, - - // Useragent RegExp - rwebkit = /(webkit)[ \/]([\w.]+)/, - ropera = /(opera)(?:.*version)?[ \/]([\w.]+)/, - rmsie = /(msie) ([\w.]+)/, - rmozilla = /(mozilla)(?:.*? rv:([\w.]+))?/, - - // Matches dashed string for camelizing - rdashAlpha = /-([a-z]|[0-9])/ig, - rmsPrefix = /^-ms-/, - - // Used by jQuery.camelCase as callback to replace() - fcamelCase = function( all, letter ) { - return ( letter + "" ).toUpperCase(); - }, - - // Keep a UserAgent string for use with jQuery.browser - userAgent = navigator.userAgent, - - // For matching the engine and version of the browser - browserMatch, - - // The deferred used on DOM ready - readyList, - - // The ready event handler - DOMContentLoaded, - - // Save a reference to some core methods - toString = Object.prototype.toString, - hasOwn = Object.prototype.hasOwnProperty, - push = Array.prototype.push, - slice = Array.prototype.slice, - trim = String.prototype.trim, - indexOf = Array.prototype.indexOf, - - // [[Class]] -> type pairs - class2type = {}; - -jQuery.fn = jQuery.prototype = { - constructor: jQuery, - init: function( selector, context, rootjQuery ) { - var match, elem, ret, doc; - - // Handle $(""), $(null), or $(undefined) - if ( !selector ) { - return this; - } - - // Handle $(DOMElement) - if ( selector.nodeType ) { - this.context = this[0] = selector; - this.length = 1; - return this; - } - - // The body element only exists once, optimize finding it - if ( selector === "body" && !context && document.body ) { - this.context = document; - this[0] = document.body; - this.selector = selector; - this.length = 1; - return this; - } - - // Handle HTML strings - if ( typeof selector === "string" ) { - // Are we dealing with HTML string or an ID? - if ( selector.charAt(0) === "<" && selector.charAt( selector.length - 1 ) === ">" && selector.length >= 3 ) { - // Assume that strings that start and end with <> are HTML and skip the regex check - match = [ null, selector, null ]; - - } else { - match = quickExpr.exec( selector ); - } - - // Verify a match, and that no context was specified for #id - if ( match && (match[1] || !context) ) { - - // HANDLE: $(html) -> $(array) - if ( match[1] ) { - context = context instanceof jQuery ? context[0] : context; - doc = (context ? context.ownerDocument || context : document); - - // If a single string is passed in and it's a single tag - // just do a createElement and skip the rest - ret = rsingleTag.exec( selector ); - - if ( ret ) { - if ( jQuery.isPlainObject( context ) ) { - selector = [ document.createElement( ret[1] ) ]; - jQuery.fn.attr.call( selector, context, true ); - - } else { - selector = [ doc.createElement( ret[1] ) ]; - } - - } else { - ret = jQuery.buildFragment( [ match[1] ], [ doc ] ); - selector = (ret.cacheable ? jQuery.clone(ret.fragment) : ret.fragment).childNodes; - } - - return jQuery.merge( this, selector ); - - // HANDLE: $("#id") - } else { - elem = document.getElementById( match[2] ); - - // Check parentNode to catch when Blackberry 4.6 returns - // nodes that are no longer in the document #6963 - if ( elem && elem.parentNode ) { - // Handle the case where IE and Opera return items - // by name instead of ID - if ( elem.id !== match[2] ) { - return rootjQuery.find( selector ); - } - - // Otherwise, we inject the element directly into the jQuery object - this.length = 1; - this[0] = elem; - } - - this.context = document; - this.selector = selector; - return this; - } - - // HANDLE: $(expr, $(...)) - } else if ( !context || context.jquery ) { - return (context || rootjQuery).find( selector ); - - // HANDLE: $(expr, context) - // (which is just equivalent to: $(context).find(expr) - } else { - return this.constructor( context ).find( selector ); - } - - // HANDLE: $(function) - // Shortcut for document ready - } else if ( jQuery.isFunction( selector ) ) { - return rootjQuery.ready( selector ); - } - - if (selector.selector !== undefined) { - this.selector = selector.selector; - this.context = selector.context; - } - - return jQuery.makeArray( selector, this ); - }, - - // Start with an empty selector - selector: "", - - // The current version of jQuery being used - jquery: "1.6.4", - - // The default length of a jQuery object is 0 - length: 0, - - // The number of elements contained in the matched element set - size: function() { - return this.length; - }, - - toArray: function() { - return slice.call( this, 0 ); - }, - - // Get the Nth element in the matched element set OR - // Get the whole matched element set as a clean array - get: function( num ) { - return num == null ? - - // Return a 'clean' array - this.toArray() : - - // Return just the object - ( num < 0 ? this[ this.length + num ] : this[ num ] ); - }, - - // Take an array of elements and push it onto the stack - // (returning the new matched element set) - pushStack: function( elems, name, selector ) { - // Build a new jQuery matched element set - var ret = this.constructor(); - - if ( jQuery.isArray( elems ) ) { - push.apply( ret, elems ); - - } else { - jQuery.merge( ret, elems ); - } - - // Add the old object onto the stack (as a reference) - ret.prevObject = this; - - ret.context = this.context; - - if ( name === "find" ) { - ret.selector = this.selector + (this.selector ? " " : "") + selector; - } else if ( name ) { - ret.selector = this.selector + "." + name + "(" + selector + ")"; - } - - // Return the newly-formed element set - return ret; - }, - - // Execute a callback for every element in the matched set. - // (You can seed the arguments with an array of args, but this is - // only used internally.) - each: function( callback, args ) { - return jQuery.each( this, callback, args ); - }, - - ready: function( fn ) { - // Attach the listeners - jQuery.bindReady(); - - // Add the callback - readyList.done( fn ); - - return this; - }, - - eq: function( i ) { - return i === -1 ? - this.slice( i ) : - this.slice( i, +i + 1 ); - }, - - first: function() { - return this.eq( 0 ); - }, - - last: function() { - return this.eq( -1 ); - }, - - slice: function() { - return this.pushStack( slice.apply( this, arguments ), - "slice", slice.call(arguments).join(",") ); - }, - - map: function( callback ) { - return this.pushStack( jQuery.map(this, function( elem, i ) { - return callback.call( elem, i, elem ); - })); - }, - - end: function() { - return this.prevObject || this.constructor(null); - }, - - // For internal use only. - // Behaves like an Array's method, not like a jQuery method. - push: push, - sort: [].sort, - splice: [].splice -}; - -// Give the init function the jQuery prototype for later instantiation -jQuery.fn.init.prototype = jQuery.fn; - -jQuery.extend = jQuery.fn.extend = function() { - var options, name, src, copy, copyIsArray, clone, - target = arguments[0] || {}, - i = 1, - length = arguments.length, - deep = false; - - // Handle a deep copy situation - if ( typeof target === "boolean" ) { - deep = target; - target = arguments[1] || {}; - // skip the boolean and the target - i = 2; - } - - // Handle case when target is a string or something (possible in deep copy) - if ( typeof target !== "object" && !jQuery.isFunction(target) ) { - target = {}; - } - - // extend jQuery itself if only one argument is passed - if ( length === i ) { - target = this; - --i; - } - - for ( ; i < length; i++ ) { - // Only deal with non-null/undefined values - if ( (options = arguments[ i ]) != null ) { - // Extend the base object - for ( name in options ) { - src = target[ name ]; - copy = options[ name ]; - - // Prevent never-ending loop - if ( target === copy ) { - continue; - } - - // Recurse if we're merging plain objects or arrays - if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) { - if ( copyIsArray ) { - copyIsArray = false; - clone = src && jQuery.isArray(src) ? src : []; - - } else { - clone = src && jQuery.isPlainObject(src) ? src : {}; - } - - // Never move original objects, clone them - target[ name ] = jQuery.extend( deep, clone, copy ); - - // Don't bring in undefined values - } else if ( copy !== undefined ) { - target[ name ] = copy; - } - } - } - } - - // Return the modified object - return target; -}; - -jQuery.extend({ - noConflict: function( deep ) { - if ( window.$ === jQuery ) { - window.$ = _$; - } - - if ( deep && window.jQuery === jQuery ) { - window.jQuery = _jQuery; - } - - return jQuery; - }, - - // Is the DOM ready to be used? Set to true once it occurs. - isReady: false, - - // A counter to track how many items to wait for before - // the ready event fires. See #6781 - readyWait: 1, - - // Hold (or release) the ready event - holdReady: function( hold ) { - if ( hold ) { - jQuery.readyWait++; - } else { - jQuery.ready( true ); - } - }, - - // Handle when the DOM is ready - ready: function( wait ) { - // Either a released hold or an DOMready/load event and not yet ready - if ( (wait === true && !--jQuery.readyWait) || (wait !== true && !jQuery.isReady) ) { - // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). - if ( !document.body ) { - return setTimeout( jQuery.ready, 1 ); - } - - // Remember that the DOM is ready - jQuery.isReady = true; - - // If a normal DOM Ready event fired, decrement, and wait if need be - if ( wait !== true && --jQuery.readyWait > 0 ) { - return; - } - - // If there are functions bound, to execute - readyList.resolveWith( document, [ jQuery ] ); - - // Trigger any bound ready events - if ( jQuery.fn.trigger ) { - jQuery( document ).trigger( "ready" ).unbind( "ready" ); - } - } - }, - - bindReady: function() { - if ( readyList ) { - return; - } - - readyList = jQuery._Deferred(); - - // Catch cases where $(document).ready() is called after the - // browser event has already occurred. - if ( document.readyState === "complete" ) { - // Handle it asynchronously to allow scripts the opportunity to delay ready - return setTimeout( jQuery.ready, 1 ); - } - - // Mozilla, Opera and webkit nightlies currently support this event - if ( document.addEventListener ) { - // Use the handy event callback - document.addEventListener( "DOMContentLoaded", DOMContentLoaded, false ); - - // A fallback to window.onload, that will always work - window.addEventListener( "load", jQuery.ready, false ); - - // If IE event model is used - } else if ( document.attachEvent ) { - // ensure firing before onload, - // maybe late but safe also for iframes - document.attachEvent( "onreadystatechange", DOMContentLoaded ); - - // A fallback to window.onload, that will always work - window.attachEvent( "onload", jQuery.ready ); - - // If IE and not a frame - // continually check to see if the document is ready - var toplevel = false; - - try { - toplevel = window.frameElement == null; - } catch(e) {} - - if ( document.documentElement.doScroll && toplevel ) { - doScrollCheck(); - } - } - }, - - // See test/unit/core.js for details concerning isFunction. - // Since version 1.3, DOM methods and functions like alert - // aren't supported. They return false on IE (#2968). - isFunction: function( obj ) { - return jQuery.type(obj) === "function"; - }, - - isArray: Array.isArray || function( obj ) { - return jQuery.type(obj) === "array"; - }, - - // A crude way of determining if an object is a window - isWindow: function( obj ) { - return obj && typeof obj === "object" && "setInterval" in obj; - }, - - isNaN: function( obj ) { - return obj == null || !rdigit.test( obj ) || isNaN( obj ); - }, - - type: function( obj ) { - return obj == null ? - String( obj ) : - class2type[ toString.call(obj) ] || "object"; - }, - - isPlainObject: function( obj ) { - // Must be an Object. - // Because of IE, we also have to check the presence of the constructor property. - // Make sure that DOM nodes and window objects don't pass through, as well - if ( !obj || jQuery.type(obj) !== "object" || obj.nodeType || jQuery.isWindow( obj ) ) { - return false; - } - - try { - // Not own constructor property must be Object - if ( obj.constructor && - !hasOwn.call(obj, "constructor") && - !hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) { - return false; - } - } catch ( e ) { - // IE8,9 Will throw exceptions on certain host objects #9897 - return false; - } - - // Own properties are enumerated firstly, so to speed up, - // if last one is own, then all properties are own. - - var key; - for ( key in obj ) {} - - return key === undefined || hasOwn.call( obj, key ); - }, - - isEmptyObject: function( obj ) { - for ( var name in obj ) { - return false; - } - return true; - }, - - error: function( msg ) { - throw msg; - }, - - parseJSON: function( data ) { - if ( typeof data !== "string" || !data ) { - return null; - } - - // Make sure leading/trailing whitespace is removed (IE can't handle it) - data = jQuery.trim( data ); - - // Attempt to parse using the native JSON parser first - if ( window.JSON && window.JSON.parse ) { - return window.JSON.parse( data ); - } - - // Make sure the incoming data is actual JSON - // Logic borrowed from http://json.org/json2.js - if ( rvalidchars.test( data.replace( rvalidescape, "@" ) - .replace( rvalidtokens, "]" ) - .replace( rvalidbraces, "")) ) { - - return (new Function( "return " + data ))(); - - } - jQuery.error( "Invalid JSON: " + data ); - }, - - // Cross-browser xml parsing - parseXML: function( data ) { - var xml, tmp; - try { - if ( window.DOMParser ) { // Standard - tmp = new DOMParser(); - xml = tmp.parseFromString( data , "text/xml" ); - } else { // IE - xml = new ActiveXObject( "Microsoft.XMLDOM" ); - xml.async = "false"; - xml.loadXML( data ); - } - } catch( e ) { - xml = undefined; - } - if ( !xml || !xml.documentElement || xml.getElementsByTagName( "parsererror" ).length ) { - jQuery.error( "Invalid XML: " + data ); - } - return xml; - }, - - noop: function() {}, - - // Evaluates a script in a global context - // Workarounds based on findings by Jim Driscoll - // http://weblogs.java.net/blog/driscoll/archive/2009/09/08/eval-javascript-global-context - globalEval: function( data ) { - if ( data && rnotwhite.test( data ) ) { - // We use execScript on Internet Explorer - // We use an anonymous function so that context is window - // rather than jQuery in Firefox - ( window.execScript || function( data ) { - window[ "eval" ].call( window, data ); - } )( data ); - } - }, - - // Convert dashed to camelCase; used by the css and data modules - // Microsoft forgot to hump their vendor prefix (#9572) - camelCase: function( string ) { - return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); - }, - - nodeName: function( elem, name ) { - return elem.nodeName && elem.nodeName.toUpperCase() === name.toUpperCase(); - }, - - // args is for internal usage only - each: function( object, callback, args ) { - var name, i = 0, - length = object.length, - isObj = length === undefined || jQuery.isFunction( object ); - - if ( args ) { - if ( isObj ) { - for ( name in object ) { - if ( callback.apply( object[ name ], args ) === false ) { - break; - } - } - } else { - for ( ; i < length; ) { - if ( callback.apply( object[ i++ ], args ) === false ) { - break; - } - } - } - - // A special, fast, case for the most common use of each - } else { - if ( isObj ) { - for ( name in object ) { - if ( callback.call( object[ name ], name, object[ name ] ) === false ) { - break; - } - } - } else { - for ( ; i < length; ) { - if ( callback.call( object[ i ], i, object[ i++ ] ) === false ) { - break; - } - } - } - } - - return object; - }, - - // Use native String.trim function wherever possible - trim: trim ? - function( text ) { - return text == null ? - "" : - trim.call( text ); - } : - - // Otherwise use our own trimming functionality - function( text ) { - return text == null ? - "" : - text.toString().replace( trimLeft, "" ).replace( trimRight, "" ); - }, - - // results is for internal usage only - makeArray: function( array, results ) { - var ret = results || []; - - if ( array != null ) { - // The window, strings (and functions) also have 'length' - // The extra typeof function check is to prevent crashes - // in Safari 2 (See: #3039) - // Tweaked logic slightly to handle Blackberry 4.7 RegExp issues #6930 - var type = jQuery.type( array ); - - if ( array.length == null || type === "string" || type === "function" || type === "regexp" || jQuery.isWindow( array ) ) { - push.call( ret, array ); - } else { - jQuery.merge( ret, array ); - } - } - - return ret; - }, - - inArray: function( elem, array ) { - if ( !array ) { - return -1; - } - - if ( indexOf ) { - return indexOf.call( array, elem ); - } - - for ( var i = 0, length = array.length; i < length; i++ ) { - if ( array[ i ] === elem ) { - return i; - } - } - - return -1; - }, - - merge: function( first, second ) { - var i = first.length, - j = 0; - - if ( typeof second.length === "number" ) { - for ( var l = second.length; j < l; j++ ) { - first[ i++ ] = second[ j ]; - } - - } else { - while ( second[j] !== undefined ) { - first[ i++ ] = second[ j++ ]; - } - } - - first.length = i; - - return first; - }, - - grep: function( elems, callback, inv ) { - var ret = [], retVal; - inv = !!inv; - - // Go through the array, only saving the items - // that pass the validator function - for ( var i = 0, length = elems.length; i < length; i++ ) { - retVal = !!callback( elems[ i ], i ); - if ( inv !== retVal ) { - ret.push( elems[ i ] ); - } - } - - return ret; - }, - - // arg is for internal usage only - map: function( elems, callback, arg ) { - var value, key, ret = [], - i = 0, - length = elems.length, - // jquery objects are treated as arrays - isArray = elems instanceof jQuery || length !== undefined && typeof length === "number" && ( ( length > 0 && elems[ 0 ] && elems[ length -1 ] ) || length === 0 || jQuery.isArray( elems ) ) ; - - // Go through the array, translating each of the items to their - if ( isArray ) { - for ( ; i < length; i++ ) { - value = callback( elems[ i ], i, arg ); - - if ( value != null ) { - ret[ ret.length ] = value; - } - } - - // Go through every key on the object, - } else { - for ( key in elems ) { - value = callback( elems[ key ], key, arg ); - - if ( value != null ) { - ret[ ret.length ] = value; - } - } - } - - // Flatten any nested arrays - return ret.concat.apply( [], ret ); - }, - - // A global GUID counter for objects - guid: 1, - - // Bind a function to a context, optionally partially applying any - // arguments. - proxy: function( fn, context ) { - if ( typeof context === "string" ) { - var tmp = fn[ context ]; - context = fn; - fn = tmp; - } - - // Quick check to determine if target is callable, in the spec - // this throws a TypeError, but we will just return undefined. - if ( !jQuery.isFunction( fn ) ) { - return undefined; - } - - // Simulated bind - var args = slice.call( arguments, 2 ), - proxy = function() { - return fn.apply( context, args.concat( slice.call( arguments ) ) ); - }; - - // Set the guid of unique handler to the same of original handler, so it can be removed - proxy.guid = fn.guid = fn.guid || proxy.guid || jQuery.guid++; - - return proxy; - }, - - // Mutifunctional method to get and set values to a collection - // The value/s can optionally be executed if it's a function - access: function( elems, key, value, exec, fn, pass ) { - var length = elems.length; - - // Setting many attributes - if ( typeof key === "object" ) { - for ( var k in key ) { - jQuery.access( elems, k, key[k], exec, fn, value ); - } - return elems; - } - - // Setting one attribute - if ( value !== undefined ) { - // Optionally, function values get executed if exec is true - exec = !pass && exec && jQuery.isFunction(value); - - for ( var i = 0; i < length; i++ ) { - fn( elems[i], key, exec ? value.call( elems[i], i, fn( elems[i], key ) ) : value, pass ); - } - - return elems; - } - - // Getting an attribute - return length ? fn( elems[0], key ) : undefined; - }, - - now: function() { - return (new Date()).getTime(); - }, - - // Use of jQuery.browser is frowned upon. - // More details: http://docs.jquery.com/Utilities/jQuery.browser - uaMatch: function( ua ) { - ua = ua.toLowerCase(); - - var match = rwebkit.exec( ua ) || - ropera.exec( ua ) || - rmsie.exec( ua ) || - ua.indexOf("compatible") < 0 && rmozilla.exec( ua ) || - []; - - return { browser: match[1] || "", version: match[2] || "0" }; - }, - - sub: function() { - function jQuerySub( selector, context ) { - return new jQuerySub.fn.init( selector, context ); - } - jQuery.extend( true, jQuerySub, this ); - jQuerySub.superclass = this; - jQuerySub.fn = jQuerySub.prototype = this(); - jQuerySub.fn.constructor = jQuerySub; - jQuerySub.sub = this.sub; - jQuerySub.fn.init = function init( selector, context ) { - if ( context && context instanceof jQuery && !(context instanceof jQuerySub) ) { - context = jQuerySub( context ); - } - - return jQuery.fn.init.call( this, selector, context, rootjQuerySub ); - }; - jQuerySub.fn.init.prototype = jQuerySub.fn; - var rootjQuerySub = jQuerySub(document); - return jQuerySub; - }, - - browser: {} -}); - -// Populate the class2type map -jQuery.each("Boolean Number String Function Array Date RegExp Object".split(" "), function(i, name) { - class2type[ "[object " + name + "]" ] = name.toLowerCase(); -}); - -browserMatch = jQuery.uaMatch( userAgent ); -if ( browserMatch.browser ) { - jQuery.browser[ browserMatch.browser ] = true; - jQuery.browser.version = browserMatch.version; -} - -// Deprecated, use jQuery.browser.webkit instead -if ( jQuery.browser.webkit ) { - jQuery.browser.safari = true; -} - -// IE doesn't match non-breaking spaces with \s -if ( rnotwhite.test( "\xA0" ) ) { - trimLeft = /^[\s\xA0]+/; - trimRight = /[\s\xA0]+$/; -} - -// All jQuery objects should point back to these -rootjQuery = jQuery(document); - -// Cleanup functions for the document ready method -if ( document.addEventListener ) { - DOMContentLoaded = function() { - document.removeEventListener( "DOMContentLoaded", DOMContentLoaded, false ); - jQuery.ready(); - }; - -} else if ( document.attachEvent ) { - DOMContentLoaded = function() { - // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). - if ( document.readyState === "complete" ) { - document.detachEvent( "onreadystatechange", DOMContentLoaded ); - jQuery.ready(); - } - }; -} - -// The DOM ready check for Internet Explorer -function doScrollCheck() { - if ( jQuery.isReady ) { - return; - } - - try { - // If IE is used, use the trick by Diego Perini - // http://javascript.nwbox.com/IEContentLoaded/ - document.documentElement.doScroll("left"); - } catch(e) { - setTimeout( doScrollCheck, 1 ); - return; - } - - // and execute any waiting functions - jQuery.ready(); -} - -return jQuery; - -})(); - - -var // Promise methods - promiseMethods = "done fail isResolved isRejected promise then always pipe".split( " " ), - // Static reference to slice - sliceDeferred = [].slice; - -jQuery.extend({ - // Create a simple deferred (one callbacks list) - _Deferred: function() { - var // callbacks list - callbacks = [], - // stored [ context , args ] - fired, - // to avoid firing when already doing so - firing, - // flag to know if the deferred has been cancelled - cancelled, - // the deferred itself - deferred = { - - // done( f1, f2, ...) - done: function() { - if ( !cancelled ) { - var args = arguments, - i, - length, - elem, - type, - _fired; - if ( fired ) { - _fired = fired; - fired = 0; - } - for ( i = 0, length = args.length; i < length; i++ ) { - elem = args[ i ]; - type = jQuery.type( elem ); - if ( type === "array" ) { - deferred.done.apply( deferred, elem ); - } else if ( type === "function" ) { - callbacks.push( elem ); - } - } - if ( _fired ) { - deferred.resolveWith( _fired[ 0 ], _fired[ 1 ] ); - } - } - return this; - }, - - // resolve with given context and args - resolveWith: function( context, args ) { - if ( !cancelled && !fired && !firing ) { - // make sure args are available (#8421) - args = args || []; - firing = 1; - try { - while( callbacks[ 0 ] ) { - callbacks.shift().apply( context, args ); - } - } - finally { - fired = [ context, args ]; - firing = 0; - } - } - return this; - }, - - // resolve with this as context and given arguments - resolve: function() { - deferred.resolveWith( this, arguments ); - return this; - }, - - // Has this deferred been resolved? - isResolved: function() { - return !!( firing || fired ); - }, - - // Cancel - cancel: function() { - cancelled = 1; - callbacks = []; - return this; - } - }; - - return deferred; - }, - - // Full fledged deferred (two callbacks list) - Deferred: function( func ) { - var deferred = jQuery._Deferred(), - failDeferred = jQuery._Deferred(), - promise; - // Add errorDeferred methods, then and promise - jQuery.extend( deferred, { - then: function( doneCallbacks, failCallbacks ) { - deferred.done( doneCallbacks ).fail( failCallbacks ); - return this; - }, - always: function() { - return deferred.done.apply( deferred, arguments ).fail.apply( this, arguments ); - }, - fail: failDeferred.done, - rejectWith: failDeferred.resolveWith, - reject: failDeferred.resolve, - isRejected: failDeferred.isResolved, - pipe: function( fnDone, fnFail ) { - return jQuery.Deferred(function( newDefer ) { - jQuery.each( { - done: [ fnDone, "resolve" ], - fail: [ fnFail, "reject" ] - }, function( handler, data ) { - var fn = data[ 0 ], - action = data[ 1 ], - returned; - if ( jQuery.isFunction( fn ) ) { - deferred[ handler ](function() { - returned = fn.apply( this, arguments ); - if ( returned && jQuery.isFunction( returned.promise ) ) { - returned.promise().then( newDefer.resolve, newDefer.reject ); - } else { - newDefer[ action + "With" ]( this === deferred ? newDefer : this, [ returned ] ); - } - }); - } else { - deferred[ handler ]( newDefer[ action ] ); - } - }); - }).promise(); - }, - // Get a promise for this deferred - // If obj is provided, the promise aspect is added to the object - promise: function( obj ) { - if ( obj == null ) { - if ( promise ) { - return promise; - } - promise = obj = {}; - } - var i = promiseMethods.length; - while( i-- ) { - obj[ promiseMethods[i] ] = deferred[ promiseMethods[i] ]; - } - return obj; - } - }); - // Make sure only one callback list will be used - deferred.done( failDeferred.cancel ).fail( deferred.cancel ); - // Unexpose cancel - delete deferred.cancel; - // Call given func if any - if ( func ) { - func.call( deferred, deferred ); - } - return deferred; - }, - - // Deferred helper - when: function( firstParam ) { - var args = arguments, - i = 0, - length = args.length, - count = length, - deferred = length <= 1 && firstParam && jQuery.isFunction( firstParam.promise ) ? - firstParam : - jQuery.Deferred(); - function resolveFunc( i ) { - return function( value ) { - args[ i ] = arguments.length > 1 ? sliceDeferred.call( arguments, 0 ) : value; - if ( !( --count ) ) { - // Strange bug in FF4: - // Values changed onto the arguments object sometimes end up as undefined values - // outside the $.when method. Cloning the object into a fresh array solves the issue - deferred.resolveWith( deferred, sliceDeferred.call( args, 0 ) ); - } - }; - } - if ( length > 1 ) { - for( ; i < length; i++ ) { - if ( args[ i ] && jQuery.isFunction( args[ i ].promise ) ) { - args[ i ].promise().then( resolveFunc(i), deferred.reject ); - } else { - --count; - } - } - if ( !count ) { - deferred.resolveWith( deferred, args ); - } - } else if ( deferred !== firstParam ) { - deferred.resolveWith( deferred, length ? [ firstParam ] : [] ); - } - return deferred.promise(); - } -}); - - - -jQuery.support = (function() { - - var div = document.createElement( "div" ), - documentElement = document.documentElement, - all, - a, - select, - opt, - input, - marginDiv, - support, - fragment, - body, - testElementParent, - testElement, - testElementStyle, - tds, - events, - eventName, - i, - isSupported; - - // Preliminary tests - div.setAttribute("className", "t"); - div.innerHTML = "
a"; - - - all = div.getElementsByTagName( "*" ); - a = div.getElementsByTagName( "a" )[ 0 ]; - - // Can't get basic test support - if ( !all || !all.length || !a ) { - return {}; - } - - // First batch of supports tests - select = document.createElement( "select" ); - opt = select.appendChild( document.createElement("option") ); - input = div.getElementsByTagName( "input" )[ 0 ]; - - support = { - // IE strips leading whitespace when .innerHTML is used - leadingWhitespace: ( div.firstChild.nodeType === 3 ), - - // Make sure that tbody elements aren't automatically inserted - // IE will insert them into empty tables - tbody: !div.getElementsByTagName( "tbody" ).length, - - // Make sure that link elements get serialized correctly by innerHTML - // This requires a wrapper element in IE - htmlSerialize: !!div.getElementsByTagName( "link" ).length, - - // Get the style information from getAttribute - // (IE uses .cssText instead) - style: /top/.test( a.getAttribute("style") ), - - // Make sure that URLs aren't manipulated - // (IE normalizes it by default) - hrefNormalized: ( a.getAttribute( "href" ) === "/a" ), - - // Make sure that element opacity exists - // (IE uses filter instead) - // Use a regex to work around a WebKit issue. See #5145 - opacity: /^0.55$/.test( a.style.opacity ), - - // Verify style float existence - // (IE uses styleFloat instead of cssFloat) - cssFloat: !!a.style.cssFloat, - - // Make sure that if no value is specified for a checkbox - // that it defaults to "on". - // (WebKit defaults to "" instead) - checkOn: ( input.value === "on" ), - - // Make sure that a selected-by-default option has a working selected property. - // (WebKit defaults to false instead of true, IE too, if it's in an optgroup) - optSelected: opt.selected, - - // Test setAttribute on camelCase class. If it works, we need attrFixes when doing get/setAttribute (ie6/7) - getSetAttribute: div.className !== "t", - - // Will be defined later - submitBubbles: true, - changeBubbles: true, - focusinBubbles: false, - deleteExpando: true, - noCloneEvent: true, - inlineBlockNeedsLayout: false, - shrinkWrapBlocks: false, - reliableMarginRight: true - }; - - // Make sure checked status is properly cloned - input.checked = true; - support.noCloneChecked = input.cloneNode( true ).checked; - - // Make sure that the options inside disabled selects aren't marked as disabled - // (WebKit marks them as disabled) - select.disabled = true; - support.optDisabled = !opt.disabled; - - // Test to see if it's possible to delete an expando from an element - // Fails in Internet Explorer - try { - delete div.test; - } catch( e ) { - support.deleteExpando = false; - } - - if ( !div.addEventListener && div.attachEvent && div.fireEvent ) { - div.attachEvent( "onclick", function() { - // Cloning a node shouldn't copy over any - // bound event handlers (IE does this) - support.noCloneEvent = false; - }); - div.cloneNode( true ).fireEvent( "onclick" ); - } - - // Check if a radio maintains it's value - // after being appended to the DOM - input = document.createElement("input"); - input.value = "t"; - input.setAttribute("type", "radio"); - support.radioValue = input.value === "t"; - - input.setAttribute("checked", "checked"); - div.appendChild( input ); - fragment = document.createDocumentFragment(); - fragment.appendChild( div.firstChild ); - - // WebKit doesn't clone checked state correctly in fragments - support.checkClone = fragment.cloneNode( true ).cloneNode( true ).lastChild.checked; - - div.innerHTML = ""; - - // Figure out if the W3C box model works as expected - div.style.width = div.style.paddingLeft = "1px"; - - body = document.getElementsByTagName( "body" )[ 0 ]; - // We use our own, invisible, body unless the body is already present - // in which case we use a div (#9239) - testElement = document.createElement( body ? "div" : "body" ); - testElementStyle = { - visibility: "hidden", - width: 0, - height: 0, - border: 0, - margin: 0, - background: "none" - }; - if ( body ) { - jQuery.extend( testElementStyle, { - position: "absolute", - left: "-1000px", - top: "-1000px" - }); - } - for ( i in testElementStyle ) { - testElement.style[ i ] = testElementStyle[ i ]; - } - testElement.appendChild( div ); - testElementParent = body || documentElement; - testElementParent.insertBefore( testElement, testElementParent.firstChild ); - - // Check if a disconnected checkbox will retain its checked - // value of true after appended to the DOM (IE6/7) - support.appendChecked = input.checked; - - support.boxModel = div.offsetWidth === 2; - - if ( "zoom" in div.style ) { - // Check if natively block-level elements act like inline-block - // elements when setting their display to 'inline' and giving - // them layout - // (IE < 8 does this) - div.style.display = "inline"; - div.style.zoom = 1; - support.inlineBlockNeedsLayout = ( div.offsetWidth === 2 ); - - // Check if elements with layout shrink-wrap their children - // (IE 6 does this) - div.style.display = ""; - div.innerHTML = "
"; - support.shrinkWrapBlocks = ( div.offsetWidth !== 2 ); - } - - div.innerHTML = "
t
"; - tds = div.getElementsByTagName( "td" ); - - // Check if table cells still have offsetWidth/Height when they are set - // to display:none and there are still other visible table cells in a - // table row; if so, offsetWidth/Height are not reliable for use when - // determining if an element has been hidden directly using - // display:none (it is still safe to use offsets if a parent element is - // hidden; don safety goggles and see bug #4512 for more information). - // (only IE 8 fails this test) - isSupported = ( tds[ 0 ].offsetHeight === 0 ); - - tds[ 0 ].style.display = ""; - tds[ 1 ].style.display = "none"; - - // Check if empty table cells still have offsetWidth/Height - // (IE < 8 fail this test) - support.reliableHiddenOffsets = isSupported && ( tds[ 0 ].offsetHeight === 0 ); - div.innerHTML = ""; - - // Check if div with explicit width and no margin-right incorrectly - // gets computed margin-right based on width of container. For more - // info see bug #3333 - // Fails in WebKit before Feb 2011 nightlies - // WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right - if ( document.defaultView && document.defaultView.getComputedStyle ) { - marginDiv = document.createElement( "div" ); - marginDiv.style.width = "0"; - marginDiv.style.marginRight = "0"; - div.appendChild( marginDiv ); - support.reliableMarginRight = - ( parseInt( ( document.defaultView.getComputedStyle( marginDiv, null ) || { marginRight: 0 } ).marginRight, 10 ) || 0 ) === 0; - } - - // Remove the body element we added - testElement.innerHTML = ""; - testElementParent.removeChild( testElement ); - - // Technique from Juriy Zaytsev - // http://thinkweb2.com/projects/prototype/detecting-event-support-without-browser-sniffing/ - // We only care about the case where non-standard event systems - // are used, namely in IE. Short-circuiting here helps us to - // avoid an eval call (in setAttribute) which can cause CSP - // to go haywire. See: https://developer.mozilla.org/en/Security/CSP - if ( div.attachEvent ) { - for( i in { - submit: 1, - change: 1, - focusin: 1 - } ) { - eventName = "on" + i; - isSupported = ( eventName in div ); - if ( !isSupported ) { - div.setAttribute( eventName, "return;" ); - isSupported = ( typeof div[ eventName ] === "function" ); - } - support[ i + "Bubbles" ] = isSupported; - } - } - - // Null connected elements to avoid leaks in IE - testElement = fragment = select = opt = body = marginDiv = div = input = null; - - return support; -})(); - -// Keep track of boxModel -jQuery.boxModel = jQuery.support.boxModel; - - - - -var rbrace = /^(?:\{.*\}|\[.*\])$/, - rmultiDash = /([A-Z])/g; - -jQuery.extend({ - cache: {}, - - // Please use with caution - uuid: 0, - - // Unique for each copy of jQuery on the page - // Non-digits removed to match rinlinejQuery - expando: "jQuery" + ( jQuery.fn.jquery + Math.random() ).replace( /\D/g, "" ), - - // The following elements throw uncatchable exceptions if you - // attempt to add expando properties to them. - noData: { - "embed": true, - // Ban all objects except for Flash (which handle expandos) - "object": "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000", - "applet": true - }, - - hasData: function( elem ) { - elem = elem.nodeType ? jQuery.cache[ elem[jQuery.expando] ] : elem[ jQuery.expando ]; - - return !!elem && !isEmptyDataObject( elem ); - }, - - data: function( elem, name, data, pvt /* Internal Use Only */ ) { - if ( !jQuery.acceptData( elem ) ) { - return; - } - - var thisCache, ret, - internalKey = jQuery.expando, - getByName = typeof name === "string", - - // We have to handle DOM nodes and JS objects differently because IE6-7 - // can't GC object references properly across the DOM-JS boundary - isNode = elem.nodeType, - - // Only DOM nodes need the global jQuery cache; JS object data is - // attached directly to the object so GC can occur automatically - cache = isNode ? jQuery.cache : elem, - - // Only defining an ID for JS objects if its cache already exists allows - // the code to shortcut on the same path as a DOM node with no cache - id = isNode ? elem[ jQuery.expando ] : elem[ jQuery.expando ] && jQuery.expando; - - // Avoid doing any more work than we need to when trying to get data on an - // object that has no data at all - if ( (!id || (pvt && id && (cache[ id ] && !cache[ id ][ internalKey ]))) && getByName && data === undefined ) { - return; - } - - if ( !id ) { - // Only DOM nodes need a new unique ID for each element since their data - // ends up in the global cache - if ( isNode ) { - elem[ jQuery.expando ] = id = ++jQuery.uuid; - } else { - id = jQuery.expando; - } - } - - if ( !cache[ id ] ) { - cache[ id ] = {}; - - // TODO: This is a hack for 1.5 ONLY. Avoids exposing jQuery - // metadata on plain JS objects when the object is serialized using - // JSON.stringify - if ( !isNode ) { - cache[ id ].toJSON = jQuery.noop; - } - } - - // An object can be passed to jQuery.data instead of a key/value pair; this gets - // shallow copied over onto the existing cache - if ( typeof name === "object" || typeof name === "function" ) { - if ( pvt ) { - cache[ id ][ internalKey ] = jQuery.extend(cache[ id ][ internalKey ], name); - } else { - cache[ id ] = jQuery.extend(cache[ id ], name); - } - } - - thisCache = cache[ id ]; - - // Internal jQuery data is stored in a separate object inside the object's data - // cache in order to avoid key collisions between internal data and user-defined - // data - if ( pvt ) { - if ( !thisCache[ internalKey ] ) { - thisCache[ internalKey ] = {}; - } - - thisCache = thisCache[ internalKey ]; - } - - if ( data !== undefined ) { - thisCache[ jQuery.camelCase( name ) ] = data; - } - - // TODO: This is a hack for 1.5 ONLY. It will be removed in 1.6. Users should - // not attempt to inspect the internal events object using jQuery.data, as this - // internal data object is undocumented and subject to change. - if ( name === "events" && !thisCache[name] ) { - return thisCache[ internalKey ] && thisCache[ internalKey ].events; - } - - // Check for both converted-to-camel and non-converted data property names - // If a data property was specified - if ( getByName ) { - - // First Try to find as-is property data - ret = thisCache[ name ]; - - // Test for null|undefined property data - if ( ret == null ) { - - // Try to find the camelCased property - ret = thisCache[ jQuery.camelCase( name ) ]; - } - } else { - ret = thisCache; - } - - return ret; - }, - - removeData: function( elem, name, pvt /* Internal Use Only */ ) { - if ( !jQuery.acceptData( elem ) ) { - return; - } - - var thisCache, - - // Reference to internal data cache key - internalKey = jQuery.expando, - - isNode = elem.nodeType, - - // See jQuery.data for more information - cache = isNode ? jQuery.cache : elem, - - // See jQuery.data for more information - id = isNode ? elem[ jQuery.expando ] : jQuery.expando; - - // If there is already no cache entry for this object, there is no - // purpose in continuing - if ( !cache[ id ] ) { - return; - } - - if ( name ) { - - thisCache = pvt ? cache[ id ][ internalKey ] : cache[ id ]; - - if ( thisCache ) { - - // Support interoperable removal of hyphenated or camelcased keys - if ( !thisCache[ name ] ) { - name = jQuery.camelCase( name ); - } - - delete thisCache[ name ]; - - // If there is no data left in the cache, we want to continue - // and let the cache object itself get destroyed - if ( !isEmptyDataObject(thisCache) ) { - return; - } - } - } - - // See jQuery.data for more information - if ( pvt ) { - delete cache[ id ][ internalKey ]; - - // Don't destroy the parent cache unless the internal data object - // had been the only thing left in it - if ( !isEmptyDataObject(cache[ id ]) ) { - return; - } - } - - var internalCache = cache[ id ][ internalKey ]; - - // Browsers that fail expando deletion also refuse to delete expandos on - // the window, but it will allow it on all other JS objects; other browsers - // don't care - // Ensure that `cache` is not a window object #10080 - if ( jQuery.support.deleteExpando || !cache.setInterval ) { - delete cache[ id ]; - } else { - cache[ id ] = null; - } - - // We destroyed the entire user cache at once because it's faster than - // iterating through each key, but we need to continue to persist internal - // data if it existed - if ( internalCache ) { - cache[ id ] = {}; - // TODO: This is a hack for 1.5 ONLY. Avoids exposing jQuery - // metadata on plain JS objects when the object is serialized using - // JSON.stringify - if ( !isNode ) { - cache[ id ].toJSON = jQuery.noop; - } - - cache[ id ][ internalKey ] = internalCache; - - // Otherwise, we need to eliminate the expando on the node to avoid - // false lookups in the cache for entries that no longer exist - } else if ( isNode ) { - // IE does not allow us to delete expando properties from nodes, - // nor does it have a removeAttribute function on Document nodes; - // we must handle all of these cases - if ( jQuery.support.deleteExpando ) { - delete elem[ jQuery.expando ]; - } else if ( elem.removeAttribute ) { - elem.removeAttribute( jQuery.expando ); - } else { - elem[ jQuery.expando ] = null; - } - } - }, - - // For internal use only. - _data: function( elem, name, data ) { - return jQuery.data( elem, name, data, true ); - }, - - // A method for determining if a DOM node can handle the data expando - acceptData: function( elem ) { - if ( elem.nodeName ) { - var match = jQuery.noData[ elem.nodeName.toLowerCase() ]; - - if ( match ) { - return !(match === true || elem.getAttribute("classid") !== match); - } - } - - return true; - } -}); - -jQuery.fn.extend({ - data: function( key, value ) { - var data = null; - - if ( typeof key === "undefined" ) { - if ( this.length ) { - data = jQuery.data( this[0] ); - - if ( this[0].nodeType === 1 ) { - var attr = this[0].attributes, name; - for ( var i = 0, l = attr.length; i < l; i++ ) { - name = attr[i].name; - - if ( name.indexOf( "data-" ) === 0 ) { - name = jQuery.camelCase( name.substring(5) ); - - dataAttr( this[0], name, data[ name ] ); - } - } - } - } - - return data; - - } else if ( typeof key === "object" ) { - return this.each(function() { - jQuery.data( this, key ); - }); - } - - var parts = key.split("."); - parts[1] = parts[1] ? "." + parts[1] : ""; - - if ( value === undefined ) { - data = this.triggerHandler("getData" + parts[1] + "!", [parts[0]]); - - // Try to fetch any internally stored data first - if ( data === undefined && this.length ) { - data = jQuery.data( this[0], key ); - data = dataAttr( this[0], key, data ); - } - - return data === undefined && parts[1] ? - this.data( parts[0] ) : - data; - - } else { - return this.each(function() { - var $this = jQuery( this ), - args = [ parts[0], value ]; - - $this.triggerHandler( "setData" + parts[1] + "!", args ); - jQuery.data( this, key, value ); - $this.triggerHandler( "changeData" + parts[1] + "!", args ); - }); - } - }, - - removeData: function( key ) { - return this.each(function() { - jQuery.removeData( this, key ); - }); - } -}); - -function dataAttr( elem, key, data ) { - // If nothing was found internally, try to fetch any - // data from the HTML5 data-* attribute - if ( data === undefined && elem.nodeType === 1 ) { - - var name = "data-" + key.replace( rmultiDash, "-$1" ).toLowerCase(); - - data = elem.getAttribute( name ); - - if ( typeof data === "string" ) { - try { - data = data === "true" ? true : - data === "false" ? false : - data === "null" ? null : - !jQuery.isNaN( data ) ? parseFloat( data ) : - rbrace.test( data ) ? jQuery.parseJSON( data ) : - data; - } catch( e ) {} - - // Make sure we set the data so it isn't changed later - jQuery.data( elem, key, data ); - - } else { - data = undefined; - } - } - - return data; -} - -// TODO: This is a hack for 1.5 ONLY to allow objects with a single toJSON -// property to be considered empty objects; this property always exists in -// order to make sure JSON.stringify does not expose internal metadata -function isEmptyDataObject( obj ) { - for ( var name in obj ) { - if ( name !== "toJSON" ) { - return false; - } - } - - return true; -} - - - - -function handleQueueMarkDefer( elem, type, src ) { - var deferDataKey = type + "defer", - queueDataKey = type + "queue", - markDataKey = type + "mark", - defer = jQuery.data( elem, deferDataKey, undefined, true ); - if ( defer && - ( src === "queue" || !jQuery.data( elem, queueDataKey, undefined, true ) ) && - ( src === "mark" || !jQuery.data( elem, markDataKey, undefined, true ) ) ) { - // Give room for hard-coded callbacks to fire first - // and eventually mark/queue something else on the element - setTimeout( function() { - if ( !jQuery.data( elem, queueDataKey, undefined, true ) && - !jQuery.data( elem, markDataKey, undefined, true ) ) { - jQuery.removeData( elem, deferDataKey, true ); - defer.resolve(); - } - }, 0 ); - } -} - -jQuery.extend({ - - _mark: function( elem, type ) { - if ( elem ) { - type = (type || "fx") + "mark"; - jQuery.data( elem, type, (jQuery.data(elem,type,undefined,true) || 0) + 1, true ); - } - }, - - _unmark: function( force, elem, type ) { - if ( force !== true ) { - type = elem; - elem = force; - force = false; - } - if ( elem ) { - type = type || "fx"; - var key = type + "mark", - count = force ? 0 : ( (jQuery.data( elem, key, undefined, true) || 1 ) - 1 ); - if ( count ) { - jQuery.data( elem, key, count, true ); - } else { - jQuery.removeData( elem, key, true ); - handleQueueMarkDefer( elem, type, "mark" ); - } - } - }, - - queue: function( elem, type, data ) { - if ( elem ) { - type = (type || "fx") + "queue"; - var q = jQuery.data( elem, type, undefined, true ); - // Speed up dequeue by getting out quickly if this is just a lookup - if ( data ) { - if ( !q || jQuery.isArray(data) ) { - q = jQuery.data( elem, type, jQuery.makeArray(data), true ); - } else { - q.push( data ); - } - } - return q || []; - } - }, - - dequeue: function( elem, type ) { - type = type || "fx"; - - var queue = jQuery.queue( elem, type ), - fn = queue.shift(), - defer; - - // If the fx queue is dequeued, always remove the progress sentinel - if ( fn === "inprogress" ) { - fn = queue.shift(); - } - - if ( fn ) { - // Add a progress sentinel to prevent the fx queue from being - // automatically dequeued - if ( type === "fx" ) { - queue.unshift("inprogress"); - } - - fn.call(elem, function() { - jQuery.dequeue(elem, type); - }); - } - - if ( !queue.length ) { - jQuery.removeData( elem, type + "queue", true ); - handleQueueMarkDefer( elem, type, "queue" ); - } - } -}); - -jQuery.fn.extend({ - queue: function( type, data ) { - if ( typeof type !== "string" ) { - data = type; - type = "fx"; - } - - if ( data === undefined ) { - return jQuery.queue( this[0], type ); - } - return this.each(function() { - var queue = jQuery.queue( this, type, data ); - - if ( type === "fx" && queue[0] !== "inprogress" ) { - jQuery.dequeue( this, type ); - } - }); - }, - dequeue: function( type ) { - return this.each(function() { - jQuery.dequeue( this, type ); - }); - }, - // Based off of the plugin by Clint Helfers, with permission. - // http://blindsignals.com/index.php/2009/07/jquery-delay/ - delay: function( time, type ) { - time = jQuery.fx ? jQuery.fx.speeds[time] || time : time; - type = type || "fx"; - - return this.queue( type, function() { - var elem = this; - setTimeout(function() { - jQuery.dequeue( elem, type ); - }, time ); - }); - }, - clearQueue: function( type ) { - return this.queue( type || "fx", [] ); - }, - // Get a promise resolved when queues of a certain type - // are emptied (fx is the type by default) - promise: function( type, object ) { - if ( typeof type !== "string" ) { - object = type; - type = undefined; - } - type = type || "fx"; - var defer = jQuery.Deferred(), - elements = this, - i = elements.length, - count = 1, - deferDataKey = type + "defer", - queueDataKey = type + "queue", - markDataKey = type + "mark", - tmp; - function resolve() { - if ( !( --count ) ) { - defer.resolveWith( elements, [ elements ] ); - } - } - while( i-- ) { - if (( tmp = jQuery.data( elements[ i ], deferDataKey, undefined, true ) || - ( jQuery.data( elements[ i ], queueDataKey, undefined, true ) || - jQuery.data( elements[ i ], markDataKey, undefined, true ) ) && - jQuery.data( elements[ i ], deferDataKey, jQuery._Deferred(), true ) )) { - count++; - tmp.done( resolve ); - } - } - resolve(); - return defer.promise(); - } -}); - - - - -var rclass = /[\n\t\r]/g, - rspace = /\s+/, - rreturn = /\r/g, - rtype = /^(?:button|input)$/i, - rfocusable = /^(?:button|input|object|select|textarea)$/i, - rclickable = /^a(?:rea)?$/i, - rboolean = /^(?:autofocus|autoplay|async|checked|controls|defer|disabled|hidden|loop|multiple|open|readonly|required|scoped|selected)$/i, - nodeHook, boolHook; - -jQuery.fn.extend({ - attr: function( name, value ) { - return jQuery.access( this, name, value, true, jQuery.attr ); - }, - - removeAttr: function( name ) { - return this.each(function() { - jQuery.removeAttr( this, name ); - }); - }, - - prop: function( name, value ) { - return jQuery.access( this, name, value, true, jQuery.prop ); - }, - - removeProp: function( name ) { - name = jQuery.propFix[ name ] || name; - return this.each(function() { - // try/catch handles cases where IE balks (such as removing a property on window) - try { - this[ name ] = undefined; - delete this[ name ]; - } catch( e ) {} - }); - }, - - addClass: function( value ) { - var classNames, i, l, elem, - setClass, c, cl; - - if ( jQuery.isFunction( value ) ) { - return this.each(function( j ) { - jQuery( this ).addClass( value.call(this, j, this.className) ); - }); - } - - if ( value && typeof value === "string" ) { - classNames = value.split( rspace ); - - for ( i = 0, l = this.length; i < l; i++ ) { - elem = this[ i ]; - - if ( elem.nodeType === 1 ) { - if ( !elem.className && classNames.length === 1 ) { - elem.className = value; - - } else { - setClass = " " + elem.className + " "; - - for ( c = 0, cl = classNames.length; c < cl; c++ ) { - if ( !~setClass.indexOf( " " + classNames[ c ] + " " ) ) { - setClass += classNames[ c ] + " "; - } - } - elem.className = jQuery.trim( setClass ); - } - } - } - } - - return this; - }, - - removeClass: function( value ) { - var classNames, i, l, elem, className, c, cl; - - if ( jQuery.isFunction( value ) ) { - return this.each(function( j ) { - jQuery( this ).removeClass( value.call(this, j, this.className) ); - }); - } - - if ( (value && typeof value === "string") || value === undefined ) { - classNames = (value || "").split( rspace ); - - for ( i = 0, l = this.length; i < l; i++ ) { - elem = this[ i ]; - - if ( elem.nodeType === 1 && elem.className ) { - if ( value ) { - className = (" " + elem.className + " ").replace( rclass, " " ); - for ( c = 0, cl = classNames.length; c < cl; c++ ) { - className = className.replace(" " + classNames[ c ] + " ", " "); - } - elem.className = jQuery.trim( className ); - - } else { - elem.className = ""; - } - } - } - } - - return this; - }, - - toggleClass: function( value, stateVal ) { - var type = typeof value, - isBool = typeof stateVal === "boolean"; - - if ( jQuery.isFunction( value ) ) { - return this.each(function( i ) { - jQuery( this ).toggleClass( value.call(this, i, this.className, stateVal), stateVal ); - }); - } - - return this.each(function() { - if ( type === "string" ) { - // toggle individual class names - var className, - i = 0, - self = jQuery( this ), - state = stateVal, - classNames = value.split( rspace ); - - while ( (className = classNames[ i++ ]) ) { - // check each className given, space seperated list - state = isBool ? state : !self.hasClass( className ); - self[ state ? "addClass" : "removeClass" ]( className ); - } - - } else if ( type === "undefined" || type === "boolean" ) { - if ( this.className ) { - // store className if set - jQuery._data( this, "__className__", this.className ); - } - - // toggle whole className - this.className = this.className || value === false ? "" : jQuery._data( this, "__className__" ) || ""; - } - }); - }, - - hasClass: function( selector ) { - var className = " " + selector + " "; - for ( var i = 0, l = this.length; i < l; i++ ) { - if ( this[i].nodeType === 1 && (" " + this[i].className + " ").replace(rclass, " ").indexOf( className ) > -1 ) { - return true; - } - } - - return false; - }, - - val: function( value ) { - var hooks, ret, - elem = this[0]; - - if ( !arguments.length ) { - if ( elem ) { - hooks = jQuery.valHooks[ elem.nodeName.toLowerCase() ] || jQuery.valHooks[ elem.type ]; - - if ( hooks && "get" in hooks && (ret = hooks.get( elem, "value" )) !== undefined ) { - return ret; - } - - ret = elem.value; - - return typeof ret === "string" ? - // handle most common string cases - ret.replace(rreturn, "") : - // handle cases where value is null/undef or number - ret == null ? "" : ret; - } - - return undefined; - } - - var isFunction = jQuery.isFunction( value ); - - return this.each(function( i ) { - var self = jQuery(this), val; - - if ( this.nodeType !== 1 ) { - return; - } - - if ( isFunction ) { - val = value.call( this, i, self.val() ); - } else { - val = value; - } - - // Treat null/undefined as ""; convert numbers to string - if ( val == null ) { - val = ""; - } else if ( typeof val === "number" ) { - val += ""; - } else if ( jQuery.isArray( val ) ) { - val = jQuery.map(val, function ( value ) { - return value == null ? "" : value + ""; - }); - } - - hooks = jQuery.valHooks[ this.nodeName.toLowerCase() ] || jQuery.valHooks[ this.type ]; - - // If set returns undefined, fall back to normal setting - if ( !hooks || !("set" in hooks) || hooks.set( this, val, "value" ) === undefined ) { - this.value = val; - } - }); - } -}); - -jQuery.extend({ - valHooks: { - option: { - get: function( elem ) { - // attributes.value is undefined in Blackberry 4.7 but - // uses .value. See #6932 - var val = elem.attributes.value; - return !val || val.specified ? elem.value : elem.text; - } - }, - select: { - get: function( elem ) { - var value, - index = elem.selectedIndex, - values = [], - options = elem.options, - one = elem.type === "select-one"; - - // Nothing was selected - if ( index < 0 ) { - return null; - } - - // Loop through all the selected options - for ( var i = one ? index : 0, max = one ? index + 1 : options.length; i < max; i++ ) { - var option = options[ i ]; - - // Don't return options that are disabled or in a disabled optgroup - if ( option.selected && (jQuery.support.optDisabled ? !option.disabled : option.getAttribute("disabled") === null) && - (!option.parentNode.disabled || !jQuery.nodeName( option.parentNode, "optgroup" )) ) { - - // Get the specific value for the option - value = jQuery( option ).val(); - - // We don't need an array for one selects - if ( one ) { - return value; - } - - // Multi-Selects return an array - values.push( value ); - } - } - - // Fixes Bug #2551 -- select.val() broken in IE after form.reset() - if ( one && !values.length && options.length ) { - return jQuery( options[ index ] ).val(); - } - - return values; - }, - - set: function( elem, value ) { - var values = jQuery.makeArray( value ); - - jQuery(elem).find("option").each(function() { - this.selected = jQuery.inArray( jQuery(this).val(), values ) >= 0; - }); - - if ( !values.length ) { - elem.selectedIndex = -1; - } - return values; - } - } - }, - - attrFn: { - val: true, - css: true, - html: true, - text: true, - data: true, - width: true, - height: true, - offset: true - }, - - attrFix: { - // Always normalize to ensure hook usage - tabindex: "tabIndex" - }, - - attr: function( elem, name, value, pass ) { - var nType = elem.nodeType; - - // don't get/set attributes on text, comment and attribute nodes - if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { - return undefined; - } - - if ( pass && name in jQuery.attrFn ) { - return jQuery( elem )[ name ]( value ); - } - - // Fallback to prop when attributes are not supported - if ( !("getAttribute" in elem) ) { - return jQuery.prop( elem, name, value ); - } - - var ret, hooks, - notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); - - // Normalize the name if needed - if ( notxml ) { - name = jQuery.attrFix[ name ] || name; - - hooks = jQuery.attrHooks[ name ]; - - if ( !hooks ) { - // Use boolHook for boolean attributes - if ( rboolean.test( name ) ) { - hooks = boolHook; - - // Use nodeHook if available( IE6/7 ) - } else if ( nodeHook ) { - hooks = nodeHook; - } - } - } - - if ( value !== undefined ) { - - if ( value === null ) { - jQuery.removeAttr( elem, name ); - return undefined; - - } else if ( hooks && "set" in hooks && notxml && (ret = hooks.set( elem, value, name )) !== undefined ) { - return ret; - - } else { - elem.setAttribute( name, "" + value ); - return value; - } - - } else if ( hooks && "get" in hooks && notxml && (ret = hooks.get( elem, name )) !== null ) { - return ret; - - } else { - - ret = elem.getAttribute( name ); - - // Non-existent attributes return null, we normalize to undefined - return ret === null ? - undefined : - ret; - } - }, - - removeAttr: function( elem, name ) { - var propName; - if ( elem.nodeType === 1 ) { - name = jQuery.attrFix[ name ] || name; - - jQuery.attr( elem, name, "" ); - elem.removeAttribute( name ); - - // Set corresponding property to false for boolean attributes - if ( rboolean.test( name ) && (propName = jQuery.propFix[ name ] || name) in elem ) { - elem[ propName ] = false; - } - } - }, - - attrHooks: { - type: { - set: function( elem, value ) { - // We can't allow the type property to be changed (since it causes problems in IE) - if ( rtype.test( elem.nodeName ) && elem.parentNode ) { - jQuery.error( "type property can't be changed" ); - } else if ( !jQuery.support.radioValue && value === "radio" && jQuery.nodeName(elem, "input") ) { - // Setting the type on a radio button after the value resets the value in IE6-9 - // Reset value to it's default in case type is set after value - // This is for element creation - var val = elem.value; - elem.setAttribute( "type", value ); - if ( val ) { - elem.value = val; - } - return value; - } - } - }, - // Use the value property for back compat - // Use the nodeHook for button elements in IE6/7 (#1954) - value: { - get: function( elem, name ) { - if ( nodeHook && jQuery.nodeName( elem, "button" ) ) { - return nodeHook.get( elem, name ); - } - return name in elem ? - elem.value : - null; - }, - set: function( elem, value, name ) { - if ( nodeHook && jQuery.nodeName( elem, "button" ) ) { - return nodeHook.set( elem, value, name ); - } - // Does not return so that setAttribute is also used - elem.value = value; - } - } - }, - - propFix: { - tabindex: "tabIndex", - readonly: "readOnly", - "for": "htmlFor", - "class": "className", - maxlength: "maxLength", - cellspacing: "cellSpacing", - cellpadding: "cellPadding", - rowspan: "rowSpan", - colspan: "colSpan", - usemap: "useMap", - frameborder: "frameBorder", - contenteditable: "contentEditable" - }, - - prop: function( elem, name, value ) { - var nType = elem.nodeType; - - // don't get/set properties on text, comment and attribute nodes - if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { - return undefined; - } - - var ret, hooks, - notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); - - if ( notxml ) { - // Fix name and attach hooks - name = jQuery.propFix[ name ] || name; - hooks = jQuery.propHooks[ name ]; - } - - if ( value !== undefined ) { - if ( hooks && "set" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ) { - return ret; - - } else { - return (elem[ name ] = value); - } - - } else { - if ( hooks && "get" in hooks && (ret = hooks.get( elem, name )) !== null ) { - return ret; - - } else { - return elem[ name ]; - } - } - }, - - propHooks: { - tabIndex: { - get: function( elem ) { - // elem.tabIndex doesn't always return the correct value when it hasn't been explicitly set - // http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ - var attributeNode = elem.getAttributeNode("tabindex"); - - return attributeNode && attributeNode.specified ? - parseInt( attributeNode.value, 10 ) : - rfocusable.test( elem.nodeName ) || rclickable.test( elem.nodeName ) && elem.href ? - 0 : - undefined; - } - } - } -}); - -// Add the tabindex propHook to attrHooks for back-compat -jQuery.attrHooks.tabIndex = jQuery.propHooks.tabIndex; - -// Hook for boolean attributes -boolHook = { - get: function( elem, name ) { - // Align boolean attributes with corresponding properties - // Fall back to attribute presence where some booleans are not supported - var attrNode; - return jQuery.prop( elem, name ) === true || ( attrNode = elem.getAttributeNode( name ) ) && attrNode.nodeValue !== false ? - name.toLowerCase() : - undefined; - }, - set: function( elem, value, name ) { - var propName; - if ( value === false ) { - // Remove boolean attributes when set to false - jQuery.removeAttr( elem, name ); - } else { - // value is true since we know at this point it's type boolean and not false - // Set boolean attributes to the same name and set the DOM property - propName = jQuery.propFix[ name ] || name; - if ( propName in elem ) { - // Only set the IDL specifically if it already exists on the element - elem[ propName ] = true; - } - - elem.setAttribute( name, name.toLowerCase() ); - } - return name; - } -}; - -// IE6/7 do not support getting/setting some attributes with get/setAttribute -if ( !jQuery.support.getSetAttribute ) { - - // Use this for any attribute in IE6/7 - // This fixes almost every IE6/7 issue - nodeHook = jQuery.valHooks.button = { - get: function( elem, name ) { - var ret; - ret = elem.getAttributeNode( name ); - // Return undefined if nodeValue is empty string - return ret && ret.nodeValue !== "" ? - ret.nodeValue : - undefined; - }, - set: function( elem, value, name ) { - // Set the existing or create a new attribute node - var ret = elem.getAttributeNode( name ); - if ( !ret ) { - ret = document.createAttribute( name ); - elem.setAttributeNode( ret ); - } - return (ret.nodeValue = value + ""); - } - }; - - // Set width and height to auto instead of 0 on empty string( Bug #8150 ) - // This is for removals - jQuery.each([ "width", "height" ], function( i, name ) { - jQuery.attrHooks[ name ] = jQuery.extend( jQuery.attrHooks[ name ], { - set: function( elem, value ) { - if ( value === "" ) { - elem.setAttribute( name, "auto" ); - return value; - } - } - }); - }); -} - - -// Some attributes require a special call on IE -if ( !jQuery.support.hrefNormalized ) { - jQuery.each([ "href", "src", "width", "height" ], function( i, name ) { - jQuery.attrHooks[ name ] = jQuery.extend( jQuery.attrHooks[ name ], { - get: function( elem ) { - var ret = elem.getAttribute( name, 2 ); - return ret === null ? undefined : ret; - } - }); - }); -} - -if ( !jQuery.support.style ) { - jQuery.attrHooks.style = { - get: function( elem ) { - // Return undefined in the case of empty string - // Normalize to lowercase since IE uppercases css property names - return elem.style.cssText.toLowerCase() || undefined; - }, - set: function( elem, value ) { - return (elem.style.cssText = "" + value); - } - }; -} - -// Safari mis-reports the default selected property of an option -// Accessing the parent's selectedIndex property fixes it -if ( !jQuery.support.optSelected ) { - jQuery.propHooks.selected = jQuery.extend( jQuery.propHooks.selected, { - get: function( elem ) { - var parent = elem.parentNode; - - if ( parent ) { - parent.selectedIndex; - - // Make sure that it also works with optgroups, see #5701 - if ( parent.parentNode ) { - parent.parentNode.selectedIndex; - } - } - return null; - } - }); -} - -// Radios and checkboxes getter/setter -if ( !jQuery.support.checkOn ) { - jQuery.each([ "radio", "checkbox" ], function() { - jQuery.valHooks[ this ] = { - get: function( elem ) { - // Handle the case where in Webkit "" is returned instead of "on" if a value isn't specified - return elem.getAttribute("value") === null ? "on" : elem.value; - } - }; - }); -} -jQuery.each([ "radio", "checkbox" ], function() { - jQuery.valHooks[ this ] = jQuery.extend( jQuery.valHooks[ this ], { - set: function( elem, value ) { - if ( jQuery.isArray( value ) ) { - return (elem.checked = jQuery.inArray( jQuery(elem).val(), value ) >= 0); - } - } - }); -}); - - - - -var rnamespaces = /\.(.*)$/, - rformElems = /^(?:textarea|input|select)$/i, - rperiod = /\./g, - rspaces = / /g, - rescape = /[^\w\s.|`]/g, - fcleanup = function( nm ) { - return nm.replace(rescape, "\\$&"); - }; - -/* - * A number of helper functions used for managing events. - * Many of the ideas behind this code originated from - * Dean Edwards' addEvent library. - */ -jQuery.event = { - - // Bind an event to an element - // Original by Dean Edwards - add: function( elem, types, handler, data ) { - if ( elem.nodeType === 3 || elem.nodeType === 8 ) { - return; - } - - if ( handler === false ) { - handler = returnFalse; - } else if ( !handler ) { - // Fixes bug #7229. Fix recommended by jdalton - return; - } - - var handleObjIn, handleObj; - - if ( handler.handler ) { - handleObjIn = handler; - handler = handleObjIn.handler; - } - - // Make sure that the function being executed has a unique ID - if ( !handler.guid ) { - handler.guid = jQuery.guid++; - } - - // Init the element's event structure - var elemData = jQuery._data( elem ); - - // If no elemData is found then we must be trying to bind to one of the - // banned noData elements - if ( !elemData ) { - return; - } - - var events = elemData.events, - eventHandle = elemData.handle; - - if ( !events ) { - elemData.events = events = {}; - } - - if ( !eventHandle ) { - elemData.handle = eventHandle = function( e ) { - // Discard the second event of a jQuery.event.trigger() and - // when an event is called after a page has unloaded - return typeof jQuery !== "undefined" && (!e || jQuery.event.triggered !== e.type) ? - jQuery.event.handle.apply( eventHandle.elem, arguments ) : - undefined; - }; - } - - // Add elem as a property of the handle function - // This is to prevent a memory leak with non-native events in IE. - eventHandle.elem = elem; - - // Handle multiple events separated by a space - // jQuery(...).bind("mouseover mouseout", fn); - types = types.split(" "); - - var type, i = 0, namespaces; - - while ( (type = types[ i++ ]) ) { - handleObj = handleObjIn ? - jQuery.extend({}, handleObjIn) : - { handler: handler, data: data }; - - // Namespaced event handlers - if ( type.indexOf(".") > -1 ) { - namespaces = type.split("."); - type = namespaces.shift(); - handleObj.namespace = namespaces.slice(0).sort().join("."); - - } else { - namespaces = []; - handleObj.namespace = ""; - } - - handleObj.type = type; - if ( !handleObj.guid ) { - handleObj.guid = handler.guid; - } - - // Get the current list of functions bound to this event - var handlers = events[ type ], - special = jQuery.event.special[ type ] || {}; - - // Init the event handler queue - if ( !handlers ) { - handlers = events[ type ] = []; - - // Check for a special event handler - // Only use addEventListener/attachEvent if the special - // events handler returns false - if ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) { - // Bind the global event handler to the element - if ( elem.addEventListener ) { - elem.addEventListener( type, eventHandle, false ); - - } else if ( elem.attachEvent ) { - elem.attachEvent( "on" + type, eventHandle ); - } - } - } - - if ( special.add ) { - special.add.call( elem, handleObj ); - - if ( !handleObj.handler.guid ) { - handleObj.handler.guid = handler.guid; - } - } - - // Add the function to the element's handler list - handlers.push( handleObj ); - - // Keep track of which events have been used, for event optimization - jQuery.event.global[ type ] = true; - } - - // Nullify elem to prevent memory leaks in IE - elem = null; - }, - - global: {}, - - // Detach an event or set of events from an element - remove: function( elem, types, handler, pos ) { - // don't do events on text and comment nodes - if ( elem.nodeType === 3 || elem.nodeType === 8 ) { - return; - } - - if ( handler === false ) { - handler = returnFalse; - } - - var ret, type, fn, j, i = 0, all, namespaces, namespace, special, eventType, handleObj, origType, - elemData = jQuery.hasData( elem ) && jQuery._data( elem ), - events = elemData && elemData.events; - - if ( !elemData || !events ) { - return; - } - - // types is actually an event object here - if ( types && types.type ) { - handler = types.handler; - types = types.type; - } - - // Unbind all events for the element - if ( !types || typeof types === "string" && types.charAt(0) === "." ) { - types = types || ""; - - for ( type in events ) { - jQuery.event.remove( elem, type + types ); - } - - return; - } - - // Handle multiple events separated by a space - // jQuery(...).unbind("mouseover mouseout", fn); - types = types.split(" "); - - while ( (type = types[ i++ ]) ) { - origType = type; - handleObj = null; - all = type.indexOf(".") < 0; - namespaces = []; - - if ( !all ) { - // Namespaced event handlers - namespaces = type.split("."); - type = namespaces.shift(); - - namespace = new RegExp("(^|\\.)" + - jQuery.map( namespaces.slice(0).sort(), fcleanup ).join("\\.(?:.*\\.)?") + "(\\.|$)"); - } - - eventType = events[ type ]; - - if ( !eventType ) { - continue; - } - - if ( !handler ) { - for ( j = 0; j < eventType.length; j++ ) { - handleObj = eventType[ j ]; - - if ( all || namespace.test( handleObj.namespace ) ) { - jQuery.event.remove( elem, origType, handleObj.handler, j ); - eventType.splice( j--, 1 ); - } - } - - continue; - } - - special = jQuery.event.special[ type ] || {}; - - for ( j = pos || 0; j < eventType.length; j++ ) { - handleObj = eventType[ j ]; - - if ( handler.guid === handleObj.guid ) { - // remove the given handler for the given type - if ( all || namespace.test( handleObj.namespace ) ) { - if ( pos == null ) { - eventType.splice( j--, 1 ); - } - - if ( special.remove ) { - special.remove.call( elem, handleObj ); - } - } - - if ( pos != null ) { - break; - } - } - } - - // remove generic event handler if no more handlers exist - if ( eventType.length === 0 || pos != null && eventType.length === 1 ) { - if ( !special.teardown || special.teardown.call( elem, namespaces ) === false ) { - jQuery.removeEvent( elem, type, elemData.handle ); - } - - ret = null; - delete events[ type ]; - } - } - - // Remove the expando if it's no longer used - if ( jQuery.isEmptyObject( events ) ) { - var handle = elemData.handle; - if ( handle ) { - handle.elem = null; - } - - delete elemData.events; - delete elemData.handle; - - if ( jQuery.isEmptyObject( elemData ) ) { - jQuery.removeData( elem, undefined, true ); - } - } - }, - - // Events that are safe to short-circuit if no handlers are attached. - // Native DOM events should not be added, they may have inline handlers. - customEvent: { - "getData": true, - "setData": true, - "changeData": true - }, - - trigger: function( event, data, elem, onlyHandlers ) { - // Event object or event type - var type = event.type || event, - namespaces = [], - exclusive; - - if ( type.indexOf("!") >= 0 ) { - // Exclusive events trigger only for the exact event (no namespaces) - type = type.slice(0, -1); - exclusive = true; - } - - if ( type.indexOf(".") >= 0 ) { - // Namespaced trigger; create a regexp to match event type in handle() - namespaces = type.split("."); - type = namespaces.shift(); - namespaces.sort(); - } - - if ( (!elem || jQuery.event.customEvent[ type ]) && !jQuery.event.global[ type ] ) { - // No jQuery handlers for this event type, and it can't have inline handlers - return; - } - - // Caller can pass in an Event, Object, or just an event type string - event = typeof event === "object" ? - // jQuery.Event object - event[ jQuery.expando ] ? event : - // Object literal - new jQuery.Event( type, event ) : - // Just the event type (string) - new jQuery.Event( type ); - - event.type = type; - event.exclusive = exclusive; - event.namespace = namespaces.join("."); - event.namespace_re = new RegExp("(^|\\.)" + namespaces.join("\\.(?:.*\\.)?") + "(\\.|$)"); - - // triggerHandler() and global events don't bubble or run the default action - if ( onlyHandlers || !elem ) { - event.preventDefault(); - event.stopPropagation(); - } - - // Handle a global trigger - if ( !elem ) { - // TODO: Stop taunting the data cache; remove global events and always attach to document - jQuery.each( jQuery.cache, function() { - // internalKey variable is just used to make it easier to find - // and potentially change this stuff later; currently it just - // points to jQuery.expando - var internalKey = jQuery.expando, - internalCache = this[ internalKey ]; - if ( internalCache && internalCache.events && internalCache.events[ type ] ) { - jQuery.event.trigger( event, data, internalCache.handle.elem ); - } - }); - return; - } - - // Don't do events on text and comment nodes - if ( elem.nodeType === 3 || elem.nodeType === 8 ) { - return; - } - - // Clean up the event in case it is being reused - event.result = undefined; - event.target = elem; - - // Clone any incoming data and prepend the event, creating the handler arg list - data = data != null ? jQuery.makeArray( data ) : []; - data.unshift( event ); - - var cur = elem, - // IE doesn't like method names with a colon (#3533, #8272) - ontype = type.indexOf(":") < 0 ? "on" + type : ""; - - // Fire event on the current element, then bubble up the DOM tree - do { - var handle = jQuery._data( cur, "handle" ); - - event.currentTarget = cur; - if ( handle ) { - handle.apply( cur, data ); - } - - // Trigger an inline bound script - if ( ontype && jQuery.acceptData( cur ) && cur[ ontype ] && cur[ ontype ].apply( cur, data ) === false ) { - event.result = false; - event.preventDefault(); - } - - // Bubble up to document, then to window - cur = cur.parentNode || cur.ownerDocument || cur === event.target.ownerDocument && window; - } while ( cur && !event.isPropagationStopped() ); - - // If nobody prevented the default action, do it now - if ( !event.isDefaultPrevented() ) { - var old, - special = jQuery.event.special[ type ] || {}; - - if ( (!special._default || special._default.call( elem.ownerDocument, event ) === false) && - !(type === "click" && jQuery.nodeName( elem, "a" )) && jQuery.acceptData( elem ) ) { - - // Call a native DOM method on the target with the same name name as the event. - // Can't use an .isFunction)() check here because IE6/7 fails that test. - // IE<9 dies on focus to hidden element (#1486), may want to revisit a try/catch. - try { - if ( ontype && elem[ type ] ) { - // Don't re-trigger an onFOO event when we call its FOO() method - old = elem[ ontype ]; - - if ( old ) { - elem[ ontype ] = null; - } - - jQuery.event.triggered = type; - elem[ type ](); - } - } catch ( ieError ) {} - - if ( old ) { - elem[ ontype ] = old; - } - - jQuery.event.triggered = undefined; - } - } - - return event.result; - }, - - handle: function( event ) { - event = jQuery.event.fix( event || window.event ); - // Snapshot the handlers list since a called handler may add/remove events. - var handlers = ((jQuery._data( this, "events" ) || {})[ event.type ] || []).slice(0), - run_all = !event.exclusive && !event.namespace, - args = Array.prototype.slice.call( arguments, 0 ); - - // Use the fix-ed Event rather than the (read-only) native event - args[0] = event; - event.currentTarget = this; - - for ( var j = 0, l = handlers.length; j < l; j++ ) { - var handleObj = handlers[ j ]; - - // Triggered event must 1) be non-exclusive and have no namespace, or - // 2) have namespace(s) a subset or equal to those in the bound event. - if ( run_all || event.namespace_re.test( handleObj.namespace ) ) { - // Pass in a reference to the handler function itself - // So that we can later remove it - event.handler = handleObj.handler; - event.data = handleObj.data; - event.handleObj = handleObj; - - var ret = handleObj.handler.apply( this, args ); - - if ( ret !== undefined ) { - event.result = ret; - if ( ret === false ) { - event.preventDefault(); - event.stopPropagation(); - } - } - - if ( event.isImmediatePropagationStopped() ) { - break; - } - } - } - return event.result; - }, - - props: "altKey attrChange attrName bubbles button cancelable charCode clientX clientY ctrlKey currentTarget data detail eventPhase fromElement handler keyCode layerX layerY metaKey newValue offsetX offsetY pageX pageY prevValue relatedNode relatedTarget screenX screenY shiftKey srcElement target toElement view wheelDelta which".split(" "), - - fix: function( event ) { - if ( event[ jQuery.expando ] ) { - return event; - } - - // store a copy of the original event object - // and "clone" to set read-only properties - var originalEvent = event; - event = jQuery.Event( originalEvent ); - - for ( var i = this.props.length, prop; i; ) { - prop = this.props[ --i ]; - event[ prop ] = originalEvent[ prop ]; - } - - // Fix target property, if necessary - if ( !event.target ) { - // Fixes #1925 where srcElement might not be defined either - event.target = event.srcElement || document; - } - - // check if target is a textnode (safari) - if ( event.target.nodeType === 3 ) { - event.target = event.target.parentNode; - } - - // Add relatedTarget, if necessary - if ( !event.relatedTarget && event.fromElement ) { - event.relatedTarget = event.fromElement === event.target ? event.toElement : event.fromElement; - } - - // Calculate pageX/Y if missing and clientX/Y available - if ( event.pageX == null && event.clientX != null ) { - var eventDocument = event.target.ownerDocument || document, - doc = eventDocument.documentElement, - body = eventDocument.body; - - event.pageX = event.clientX + (doc && doc.scrollLeft || body && body.scrollLeft || 0) - (doc && doc.clientLeft || body && body.clientLeft || 0); - event.pageY = event.clientY + (doc && doc.scrollTop || body && body.scrollTop || 0) - (doc && doc.clientTop || body && body.clientTop || 0); - } - - // Add which for key events - if ( event.which == null && (event.charCode != null || event.keyCode != null) ) { - event.which = event.charCode != null ? event.charCode : event.keyCode; - } - - // Add metaKey to non-Mac browsers (use ctrl for PC's and Meta for Macs) - if ( !event.metaKey && event.ctrlKey ) { - event.metaKey = event.ctrlKey; - } - - // Add which for click: 1 === left; 2 === middle; 3 === right - // Note: button is not normalized, so don't use it - if ( !event.which && event.button !== undefined ) { - event.which = (event.button & 1 ? 1 : ( event.button & 2 ? 3 : ( event.button & 4 ? 2 : 0 ) )); - } - - return event; - }, - - // Deprecated, use jQuery.guid instead - guid: 1E8, - - // Deprecated, use jQuery.proxy instead - proxy: jQuery.proxy, - - special: { - ready: { - // Make sure the ready event is setup - setup: jQuery.bindReady, - teardown: jQuery.noop - }, - - live: { - add: function( handleObj ) { - jQuery.event.add( this, - liveConvert( handleObj.origType, handleObj.selector ), - jQuery.extend({}, handleObj, {handler: liveHandler, guid: handleObj.handler.guid}) ); - }, - - remove: function( handleObj ) { - jQuery.event.remove( this, liveConvert( handleObj.origType, handleObj.selector ), handleObj ); - } - }, - - beforeunload: { - setup: function( data, namespaces, eventHandle ) { - // We only want to do this special case on windows - if ( jQuery.isWindow( this ) ) { - this.onbeforeunload = eventHandle; - } - }, - - teardown: function( namespaces, eventHandle ) { - if ( this.onbeforeunload === eventHandle ) { - this.onbeforeunload = null; - } - } - } - } -}; - -jQuery.removeEvent = document.removeEventListener ? - function( elem, type, handle ) { - if ( elem.removeEventListener ) { - elem.removeEventListener( type, handle, false ); - } - } : - function( elem, type, handle ) { - if ( elem.detachEvent ) { - elem.detachEvent( "on" + type, handle ); - } - }; - -jQuery.Event = function( src, props ) { - // Allow instantiation without the 'new' keyword - if ( !this.preventDefault ) { - return new jQuery.Event( src, props ); - } - - // Event object - if ( src && src.type ) { - this.originalEvent = src; - this.type = src.type; - - // Events bubbling up the document may have been marked as prevented - // by a handler lower down the tree; reflect the correct value. - this.isDefaultPrevented = (src.defaultPrevented || src.returnValue === false || - src.getPreventDefault && src.getPreventDefault()) ? returnTrue : returnFalse; - - // Event type - } else { - this.type = src; - } - - // Put explicitly provided properties onto the event object - if ( props ) { - jQuery.extend( this, props ); - } - - // timeStamp is buggy for some events on Firefox(#3843) - // So we won't rely on the native value - this.timeStamp = jQuery.now(); - - // Mark it as fixed - this[ jQuery.expando ] = true; -}; - -function returnFalse() { - return false; -} -function returnTrue() { - return true; -} - -// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding -// http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html -jQuery.Event.prototype = { - preventDefault: function() { - this.isDefaultPrevented = returnTrue; - - var e = this.originalEvent; - if ( !e ) { - return; - } - - // if preventDefault exists run it on the original event - if ( e.preventDefault ) { - e.preventDefault(); - - // otherwise set the returnValue property of the original event to false (IE) - } else { - e.returnValue = false; - } - }, - stopPropagation: function() { - this.isPropagationStopped = returnTrue; - - var e = this.originalEvent; - if ( !e ) { - return; - } - // if stopPropagation exists run it on the original event - if ( e.stopPropagation ) { - e.stopPropagation(); - } - // otherwise set the cancelBubble property of the original event to true (IE) - e.cancelBubble = true; - }, - stopImmediatePropagation: function() { - this.isImmediatePropagationStopped = returnTrue; - this.stopPropagation(); - }, - isDefaultPrevented: returnFalse, - isPropagationStopped: returnFalse, - isImmediatePropagationStopped: returnFalse -}; - -// Checks if an event happened on an element within another element -// Used in jQuery.event.special.mouseenter and mouseleave handlers -var withinElement = function( event ) { - - // Check if mouse(over|out) are still within the same parent element - var related = event.relatedTarget, - inside = false, - eventType = event.type; - - event.type = event.data; - - if ( related !== this ) { - - if ( related ) { - inside = jQuery.contains( this, related ); - } - - if ( !inside ) { - - jQuery.event.handle.apply( this, arguments ); - - event.type = eventType; - } - } -}, - -// In case of event delegation, we only need to rename the event.type, -// liveHandler will take care of the rest. -delegate = function( event ) { - event.type = event.data; - jQuery.event.handle.apply( this, arguments ); -}; - -// Create mouseenter and mouseleave events -jQuery.each({ - mouseenter: "mouseover", - mouseleave: "mouseout" -}, function( orig, fix ) { - jQuery.event.special[ orig ] = { - setup: function( data ) { - jQuery.event.add( this, fix, data && data.selector ? delegate : withinElement, orig ); - }, - teardown: function( data ) { - jQuery.event.remove( this, fix, data && data.selector ? delegate : withinElement ); - } - }; -}); - -// submit delegation -if ( !jQuery.support.submitBubbles ) { - - jQuery.event.special.submit = { - setup: function( data, namespaces ) { - if ( !jQuery.nodeName( this, "form" ) ) { - jQuery.event.add(this, "click.specialSubmit", function( e ) { - // Avoid triggering error on non-existent type attribute in IE VML (#7071) - var elem = e.target, - type = jQuery.nodeName( elem, "input" ) || jQuery.nodeName( elem, "button" ) ? elem.type : ""; - - if ( (type === "submit" || type === "image") && jQuery( elem ).closest("form").length ) { - trigger( "submit", this, arguments ); - } - }); - - jQuery.event.add(this, "keypress.specialSubmit", function( e ) { - var elem = e.target, - type = jQuery.nodeName( elem, "input" ) || jQuery.nodeName( elem, "button" ) ? elem.type : ""; - - if ( (type === "text" || type === "password") && jQuery( elem ).closest("form").length && e.keyCode === 13 ) { - trigger( "submit", this, arguments ); - } - }); - - } else { - return false; - } - }, - - teardown: function( namespaces ) { - jQuery.event.remove( this, ".specialSubmit" ); - } - }; - -} - -// change delegation, happens here so we have bind. -if ( !jQuery.support.changeBubbles ) { - - var changeFilters, - - getVal = function( elem ) { - var type = jQuery.nodeName( elem, "input" ) ? elem.type : "", - val = elem.value; - - if ( type === "radio" || type === "checkbox" ) { - val = elem.checked; - - } else if ( type === "select-multiple" ) { - val = elem.selectedIndex > -1 ? - jQuery.map( elem.options, function( elem ) { - return elem.selected; - }).join("-") : - ""; - - } else if ( jQuery.nodeName( elem, "select" ) ) { - val = elem.selectedIndex; - } - - return val; - }, - - testChange = function testChange( e ) { - var elem = e.target, data, val; - - if ( !rformElems.test( elem.nodeName ) || elem.readOnly ) { - return; - } - - data = jQuery._data( elem, "_change_data" ); - val = getVal(elem); - - // the current data will be also retrieved by beforeactivate - if ( e.type !== "focusout" || elem.type !== "radio" ) { - jQuery._data( elem, "_change_data", val ); - } - - if ( data === undefined || val === data ) { - return; - } - - if ( data != null || val ) { - e.type = "change"; - e.liveFired = undefined; - jQuery.event.trigger( e, arguments[1], elem ); - } - }; - - jQuery.event.special.change = { - filters: { - focusout: testChange, - - beforedeactivate: testChange, - - click: function( e ) { - var elem = e.target, type = jQuery.nodeName( elem, "input" ) ? elem.type : ""; - - if ( type === "radio" || type === "checkbox" || jQuery.nodeName( elem, "select" ) ) { - testChange.call( this, e ); - } - }, - - // Change has to be called before submit - // Keydown will be called before keypress, which is used in submit-event delegation - keydown: function( e ) { - var elem = e.target, type = jQuery.nodeName( elem, "input" ) ? elem.type : ""; - - if ( (e.keyCode === 13 && !jQuery.nodeName( elem, "textarea" ) ) || - (e.keyCode === 32 && (type === "checkbox" || type === "radio")) || - type === "select-multiple" ) { - testChange.call( this, e ); - } - }, - - // Beforeactivate happens also before the previous element is blurred - // with this event you can't trigger a change event, but you can store - // information - beforeactivate: function( e ) { - var elem = e.target; - jQuery._data( elem, "_change_data", getVal(elem) ); - } - }, - - setup: function( data, namespaces ) { - if ( this.type === "file" ) { - return false; - } - - for ( var type in changeFilters ) { - jQuery.event.add( this, type + ".specialChange", changeFilters[type] ); - } - - return rformElems.test( this.nodeName ); - }, - - teardown: function( namespaces ) { - jQuery.event.remove( this, ".specialChange" ); - - return rformElems.test( this.nodeName ); - } - }; - - changeFilters = jQuery.event.special.change.filters; - - // Handle when the input is .focus()'d - changeFilters.focus = changeFilters.beforeactivate; -} - -function trigger( type, elem, args ) { - // Piggyback on a donor event to simulate a different one. - // Fake originalEvent to avoid donor's stopPropagation, but if the - // simulated event prevents default then we do the same on the donor. - // Don't pass args or remember liveFired; they apply to the donor event. - var event = jQuery.extend( {}, args[ 0 ] ); - event.type = type; - event.originalEvent = {}; - event.liveFired = undefined; - jQuery.event.handle.call( elem, event ); - if ( event.isDefaultPrevented() ) { - args[ 0 ].preventDefault(); - } -} - -// Create "bubbling" focus and blur events -if ( !jQuery.support.focusinBubbles ) { - jQuery.each({ focus: "focusin", blur: "focusout" }, function( orig, fix ) { - - // Attach a single capturing handler while someone wants focusin/focusout - var attaches = 0; - - jQuery.event.special[ fix ] = { - setup: function() { - if ( attaches++ === 0 ) { - document.addEventListener( orig, handler, true ); - } - }, - teardown: function() { - if ( --attaches === 0 ) { - document.removeEventListener( orig, handler, true ); - } - } - }; - - function handler( donor ) { - // Donor event is always a native one; fix it and switch its type. - // Let focusin/out handler cancel the donor focus/blur event. - var e = jQuery.event.fix( donor ); - e.type = fix; - e.originalEvent = {}; - jQuery.event.trigger( e, null, e.target ); - if ( e.isDefaultPrevented() ) { - donor.preventDefault(); - } - } - }); -} - -jQuery.each(["bind", "one"], function( i, name ) { - jQuery.fn[ name ] = function( type, data, fn ) { - var handler; - - // Handle object literals - if ( typeof type === "object" ) { - for ( var key in type ) { - this[ name ](key, data, type[key], fn); - } - return this; - } - - if ( arguments.length === 2 || data === false ) { - fn = data; - data = undefined; - } - - if ( name === "one" ) { - handler = function( event ) { - jQuery( this ).unbind( event, handler ); - return fn.apply( this, arguments ); - }; - handler.guid = fn.guid || jQuery.guid++; - } else { - handler = fn; - } - - if ( type === "unload" && name !== "one" ) { - this.one( type, data, fn ); - - } else { - for ( var i = 0, l = this.length; i < l; i++ ) { - jQuery.event.add( this[i], type, handler, data ); - } - } - - return this; - }; -}); - -jQuery.fn.extend({ - unbind: function( type, fn ) { - // Handle object literals - if ( typeof type === "object" && !type.preventDefault ) { - for ( var key in type ) { - this.unbind(key, type[key]); - } - - } else { - for ( var i = 0, l = this.length; i < l; i++ ) { - jQuery.event.remove( this[i], type, fn ); - } - } - - return this; - }, - - delegate: function( selector, types, data, fn ) { - return this.live( types, data, fn, selector ); - }, - - undelegate: function( selector, types, fn ) { - if ( arguments.length === 0 ) { - return this.unbind( "live" ); - - } else { - return this.die( types, null, fn, selector ); - } - }, - - trigger: function( type, data ) { - return this.each(function() { - jQuery.event.trigger( type, data, this ); - }); - }, - - triggerHandler: function( type, data ) { - if ( this[0] ) { - return jQuery.event.trigger( type, data, this[0], true ); - } - }, - - toggle: function( fn ) { - // Save reference to arguments for access in closure - var args = arguments, - guid = fn.guid || jQuery.guid++, - i = 0, - toggler = function( event ) { - // Figure out which function to execute - var lastToggle = ( jQuery.data( this, "lastToggle" + fn.guid ) || 0 ) % i; - jQuery.data( this, "lastToggle" + fn.guid, lastToggle + 1 ); - - // Make sure that clicks stop - event.preventDefault(); - - // and execute the function - return args[ lastToggle ].apply( this, arguments ) || false; - }; - - // link all the functions, so any of them can unbind this click handler - toggler.guid = guid; - while ( i < args.length ) { - args[ i++ ].guid = guid; - } - - return this.click( toggler ); - }, - - hover: function( fnOver, fnOut ) { - return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver ); - } -}); - -var liveMap = { - focus: "focusin", - blur: "focusout", - mouseenter: "mouseover", - mouseleave: "mouseout" -}; - -jQuery.each(["live", "die"], function( i, name ) { - jQuery.fn[ name ] = function( types, data, fn, origSelector /* Internal Use Only */ ) { - var type, i = 0, match, namespaces, preType, - selector = origSelector || this.selector, - context = origSelector ? this : jQuery( this.context ); - - if ( typeof types === "object" && !types.preventDefault ) { - for ( var key in types ) { - context[ name ]( key, data, types[key], selector ); - } - - return this; - } - - if ( name === "die" && !types && - origSelector && origSelector.charAt(0) === "." ) { - - context.unbind( origSelector ); - - return this; - } - - if ( data === false || jQuery.isFunction( data ) ) { - fn = data || returnFalse; - data = undefined; - } - - types = (types || "").split(" "); - - while ( (type = types[ i++ ]) != null ) { - match = rnamespaces.exec( type ); - namespaces = ""; - - if ( match ) { - namespaces = match[0]; - type = type.replace( rnamespaces, "" ); - } - - if ( type === "hover" ) { - types.push( "mouseenter" + namespaces, "mouseleave" + namespaces ); - continue; - } - - preType = type; - - if ( liveMap[ type ] ) { - types.push( liveMap[ type ] + namespaces ); - type = type + namespaces; - - } else { - type = (liveMap[ type ] || type) + namespaces; - } - - if ( name === "live" ) { - // bind live handler - for ( var j = 0, l = context.length; j < l; j++ ) { - jQuery.event.add( context[j], "live." + liveConvert( type, selector ), - { data: data, selector: selector, handler: fn, origType: type, origHandler: fn, preType: preType } ); - } - - } else { - // unbind live handler - context.unbind( "live." + liveConvert( type, selector ), fn ); - } - } - - return this; - }; -}); - -function liveHandler( event ) { - var stop, maxLevel, related, match, handleObj, elem, j, i, l, data, close, namespace, ret, - elems = [], - selectors = [], - events = jQuery._data( this, "events" ); - - // Make sure we avoid non-left-click bubbling in Firefox (#3861) and disabled elements in IE (#6911) - if ( event.liveFired === this || !events || !events.live || event.target.disabled || event.button && event.type === "click" ) { - return; - } - - if ( event.namespace ) { - namespace = new RegExp("(^|\\.)" + event.namespace.split(".").join("\\.(?:.*\\.)?") + "(\\.|$)"); - } - - event.liveFired = this; - - var live = events.live.slice(0); - - for ( j = 0; j < live.length; j++ ) { - handleObj = live[j]; - - if ( handleObj.origType.replace( rnamespaces, "" ) === event.type ) { - selectors.push( handleObj.selector ); - - } else { - live.splice( j--, 1 ); - } - } - - match = jQuery( event.target ).closest( selectors, event.currentTarget ); - - for ( i = 0, l = match.length; i < l; i++ ) { - close = match[i]; - - for ( j = 0; j < live.length; j++ ) { - handleObj = live[j]; - - if ( close.selector === handleObj.selector && (!namespace || namespace.test( handleObj.namespace )) && !close.elem.disabled ) { - elem = close.elem; - related = null; - - // Those two events require additional checking - if ( handleObj.preType === "mouseenter" || handleObj.preType === "mouseleave" ) { - event.type = handleObj.preType; - related = jQuery( event.relatedTarget ).closest( handleObj.selector )[0]; - - // Make sure not to accidentally match a child element with the same selector - if ( related && jQuery.contains( elem, related ) ) { - related = elem; - } - } - - if ( !related || related !== elem ) { - elems.push({ elem: elem, handleObj: handleObj, level: close.level }); - } - } - } - } - - for ( i = 0, l = elems.length; i < l; i++ ) { - match = elems[i]; - - if ( maxLevel && match.level > maxLevel ) { - break; - } - - event.currentTarget = match.elem; - event.data = match.handleObj.data; - event.handleObj = match.handleObj; - - ret = match.handleObj.origHandler.apply( match.elem, arguments ); - - if ( ret === false || event.isPropagationStopped() ) { - maxLevel = match.level; - - if ( ret === false ) { - stop = false; - } - if ( event.isImmediatePropagationStopped() ) { - break; - } - } - } - - return stop; -} - -function liveConvert( type, selector ) { - return (type && type !== "*" ? type + "." : "") + selector.replace(rperiod, "`").replace(rspaces, "&"); -} - -jQuery.each( ("blur focus focusin focusout load resize scroll unload click dblclick " + - "mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " + - "change select submit keydown keypress keyup error").split(" "), function( i, name ) { - - // Handle event binding - jQuery.fn[ name ] = function( data, fn ) { - if ( fn == null ) { - fn = data; - data = null; - } - - return arguments.length > 0 ? - this.bind( name, data, fn ) : - this.trigger( name ); - }; - - if ( jQuery.attrFn ) { - jQuery.attrFn[ name ] = true; - } -}); - - - -/*! - * Sizzle CSS Selector Engine - * Copyright 2011, The Dojo Foundation - * Released under the MIT, BSD, and GPL Licenses. - * More information: http://sizzlejs.com/ - */ -(function(){ - -var chunker = /((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^\[\]]*\]|['"][^'"]*['"]|[^\[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g, - done = 0, - toString = Object.prototype.toString, - hasDuplicate = false, - baseHasDuplicate = true, - rBackslash = /\\/g, - rNonWord = /\W/; - -// Here we check if the JavaScript engine is using some sort of -// optimization where it does not always call our comparision -// function. If that is the case, discard the hasDuplicate value. -// Thus far that includes Google Chrome. -[0, 0].sort(function() { - baseHasDuplicate = false; - return 0; -}); - -var Sizzle = function( selector, context, results, seed ) { - results = results || []; - context = context || document; - - var origContext = context; - - if ( context.nodeType !== 1 && context.nodeType !== 9 ) { - return []; - } - - if ( !selector || typeof selector !== "string" ) { - return results; - } - - var m, set, checkSet, extra, ret, cur, pop, i, - prune = true, - contextXML = Sizzle.isXML( context ), - parts = [], - soFar = selector; - - // Reset the position of the chunker regexp (start from head) - do { - chunker.exec( "" ); - m = chunker.exec( soFar ); - - if ( m ) { - soFar = m[3]; - - parts.push( m[1] ); - - if ( m[2] ) { - extra = m[3]; - break; - } - } - } while ( m ); - - if ( parts.length > 1 && origPOS.exec( selector ) ) { - - if ( parts.length === 2 && Expr.relative[ parts[0] ] ) { - set = posProcess( parts[0] + parts[1], context ); - - } else { - set = Expr.relative[ parts[0] ] ? - [ context ] : - Sizzle( parts.shift(), context ); - - while ( parts.length ) { - selector = parts.shift(); - - if ( Expr.relative[ selector ] ) { - selector += parts.shift(); - } - - set = posProcess( selector, set ); - } - } - - } else { - // Take a shortcut and set the context if the root selector is an ID - // (but not if it'll be faster if the inner selector is an ID) - if ( !seed && parts.length > 1 && context.nodeType === 9 && !contextXML && - Expr.match.ID.test(parts[0]) && !Expr.match.ID.test(parts[parts.length - 1]) ) { - - ret = Sizzle.find( parts.shift(), context, contextXML ); - context = ret.expr ? - Sizzle.filter( ret.expr, ret.set )[0] : - ret.set[0]; - } - - if ( context ) { - ret = seed ? - { expr: parts.pop(), set: makeArray(seed) } : - Sizzle.find( parts.pop(), parts.length === 1 && (parts[0] === "~" || parts[0] === "+") && context.parentNode ? context.parentNode : context, contextXML ); - - set = ret.expr ? - Sizzle.filter( ret.expr, ret.set ) : - ret.set; - - if ( parts.length > 0 ) { - checkSet = makeArray( set ); - - } else { - prune = false; - } - - while ( parts.length ) { - cur = parts.pop(); - pop = cur; - - if ( !Expr.relative[ cur ] ) { - cur = ""; - } else { - pop = parts.pop(); - } - - if ( pop == null ) { - pop = context; - } - - Expr.relative[ cur ]( checkSet, pop, contextXML ); - } - - } else { - checkSet = parts = []; - } - } - - if ( !checkSet ) { - checkSet = set; - } - - if ( !checkSet ) { - Sizzle.error( cur || selector ); - } - - if ( toString.call(checkSet) === "[object Array]" ) { - if ( !prune ) { - results.push.apply( results, checkSet ); - - } else if ( context && context.nodeType === 1 ) { - for ( i = 0; checkSet[i] != null; i++ ) { - if ( checkSet[i] && (checkSet[i] === true || checkSet[i].nodeType === 1 && Sizzle.contains(context, checkSet[i])) ) { - results.push( set[i] ); - } - } - - } else { - for ( i = 0; checkSet[i] != null; i++ ) { - if ( checkSet[i] && checkSet[i].nodeType === 1 ) { - results.push( set[i] ); - } - } - } - - } else { - makeArray( checkSet, results ); - } - - if ( extra ) { - Sizzle( extra, origContext, results, seed ); - Sizzle.uniqueSort( results ); - } - - return results; -}; - -Sizzle.uniqueSort = function( results ) { - if ( sortOrder ) { - hasDuplicate = baseHasDuplicate; - results.sort( sortOrder ); - - if ( hasDuplicate ) { - for ( var i = 1; i < results.length; i++ ) { - if ( results[i] === results[ i - 1 ] ) { - results.splice( i--, 1 ); - } - } - } - } - - return results; -}; - -Sizzle.matches = function( expr, set ) { - return Sizzle( expr, null, null, set ); -}; - -Sizzle.matchesSelector = function( node, expr ) { - return Sizzle( expr, null, null, [node] ).length > 0; -}; - -Sizzle.find = function( expr, context, isXML ) { - var set; - - if ( !expr ) { - return []; - } - - for ( var i = 0, l = Expr.order.length; i < l; i++ ) { - var match, - type = Expr.order[i]; - - if ( (match = Expr.leftMatch[ type ].exec( expr )) ) { - var left = match[1]; - match.splice( 1, 1 ); - - if ( left.substr( left.length - 1 ) !== "\\" ) { - match[1] = (match[1] || "").replace( rBackslash, "" ); - set = Expr.find[ type ]( match, context, isXML ); - - if ( set != null ) { - expr = expr.replace( Expr.match[ type ], "" ); - break; - } - } - } - } - - if ( !set ) { - set = typeof context.getElementsByTagName !== "undefined" ? - context.getElementsByTagName( "*" ) : - []; - } - - return { set: set, expr: expr }; -}; - -Sizzle.filter = function( expr, set, inplace, not ) { - var match, anyFound, - old = expr, - result = [], - curLoop = set, - isXMLFilter = set && set[0] && Sizzle.isXML( set[0] ); - - while ( expr && set.length ) { - for ( var type in Expr.filter ) { - if ( (match = Expr.leftMatch[ type ].exec( expr )) != null && match[2] ) { - var found, item, - filter = Expr.filter[ type ], - left = match[1]; - - anyFound = false; - - match.splice(1,1); - - if ( left.substr( left.length - 1 ) === "\\" ) { - continue; - } - - if ( curLoop === result ) { - result = []; - } - - if ( Expr.preFilter[ type ] ) { - match = Expr.preFilter[ type ]( match, curLoop, inplace, result, not, isXMLFilter ); - - if ( !match ) { - anyFound = found = true; - - } else if ( match === true ) { - continue; - } - } - - if ( match ) { - for ( var i = 0; (item = curLoop[i]) != null; i++ ) { - if ( item ) { - found = filter( item, match, i, curLoop ); - var pass = not ^ !!found; - - if ( inplace && found != null ) { - if ( pass ) { - anyFound = true; - - } else { - curLoop[i] = false; - } - - } else if ( pass ) { - result.push( item ); - anyFound = true; - } - } - } - } - - if ( found !== undefined ) { - if ( !inplace ) { - curLoop = result; - } - - expr = expr.replace( Expr.match[ type ], "" ); - - if ( !anyFound ) { - return []; - } - - break; - } - } - } - - // Improper expression - if ( expr === old ) { - if ( anyFound == null ) { - Sizzle.error( expr ); - - } else { - break; - } - } - - old = expr; - } - - return curLoop; -}; - -Sizzle.error = function( msg ) { - throw "Syntax error, unrecognized expression: " + msg; -}; - -var Expr = Sizzle.selectors = { - order: [ "ID", "NAME", "TAG" ], - - match: { - ID: /#((?:[\w\u00c0-\uFFFF\-]|\\.)+)/, - CLASS: /\.((?:[\w\u00c0-\uFFFF\-]|\\.)+)/, - NAME: /\[name=['"]*((?:[\w\u00c0-\uFFFF\-]|\\.)+)['"]*\]/, - ATTR: /\[\s*((?:[\w\u00c0-\uFFFF\-]|\\.)+)\s*(?:(\S?=)\s*(?:(['"])(.*?)\3|(#?(?:[\w\u00c0-\uFFFF\-]|\\.)*)|)|)\s*\]/, - TAG: /^((?:[\w\u00c0-\uFFFF\*\-]|\\.)+)/, - CHILD: /:(only|nth|last|first)-child(?:\(\s*(even|odd|(?:[+\-]?\d+|(?:[+\-]?\d*)?n\s*(?:[+\-]\s*\d+)?))\s*\))?/, - POS: /:(nth|eq|gt|lt|first|last|even|odd)(?:\((\d*)\))?(?=[^\-]|$)/, - PSEUDO: /:((?:[\w\u00c0-\uFFFF\-]|\\.)+)(?:\((['"]?)((?:\([^\)]+\)|[^\(\)]*)+)\2\))?/ - }, - - leftMatch: {}, - - attrMap: { - "class": "className", - "for": "htmlFor" - }, - - attrHandle: { - href: function( elem ) { - return elem.getAttribute( "href" ); - }, - type: function( elem ) { - return elem.getAttribute( "type" ); - } - }, - - relative: { - "+": function(checkSet, part){ - var isPartStr = typeof part === "string", - isTag = isPartStr && !rNonWord.test( part ), - isPartStrNotTag = isPartStr && !isTag; - - if ( isTag ) { - part = part.toLowerCase(); - } - - for ( var i = 0, l = checkSet.length, elem; i < l; i++ ) { - if ( (elem = checkSet[i]) ) { - while ( (elem = elem.previousSibling) && elem.nodeType !== 1 ) {} - - checkSet[i] = isPartStrNotTag || elem && elem.nodeName.toLowerCase() === part ? - elem || false : - elem === part; - } - } - - if ( isPartStrNotTag ) { - Sizzle.filter( part, checkSet, true ); - } - }, - - ">": function( checkSet, part ) { - var elem, - isPartStr = typeof part === "string", - i = 0, - l = checkSet.length; - - if ( isPartStr && !rNonWord.test( part ) ) { - part = part.toLowerCase(); - - for ( ; i < l; i++ ) { - elem = checkSet[i]; - - if ( elem ) { - var parent = elem.parentNode; - checkSet[i] = parent.nodeName.toLowerCase() === part ? parent : false; - } - } - - } else { - for ( ; i < l; i++ ) { - elem = checkSet[i]; - - if ( elem ) { - checkSet[i] = isPartStr ? - elem.parentNode : - elem.parentNode === part; - } - } - - if ( isPartStr ) { - Sizzle.filter( part, checkSet, true ); - } - } - }, - - "": function(checkSet, part, isXML){ - var nodeCheck, - doneName = done++, - checkFn = dirCheck; - - if ( typeof part === "string" && !rNonWord.test( part ) ) { - part = part.toLowerCase(); - nodeCheck = part; - checkFn = dirNodeCheck; - } - - checkFn( "parentNode", part, doneName, checkSet, nodeCheck, isXML ); - }, - - "~": function( checkSet, part, isXML ) { - var nodeCheck, - doneName = done++, - checkFn = dirCheck; - - if ( typeof part === "string" && !rNonWord.test( part ) ) { - part = part.toLowerCase(); - nodeCheck = part; - checkFn = dirNodeCheck; - } - - checkFn( "previousSibling", part, doneName, checkSet, nodeCheck, isXML ); - } - }, - - find: { - ID: function( match, context, isXML ) { - if ( typeof context.getElementById !== "undefined" && !isXML ) { - var m = context.getElementById(match[1]); - // Check parentNode to catch when Blackberry 4.6 returns - // nodes that are no longer in the document #6963 - return m && m.parentNode ? [m] : []; - } - }, - - NAME: function( match, context ) { - if ( typeof context.getElementsByName !== "undefined" ) { - var ret = [], - results = context.getElementsByName( match[1] ); - - for ( var i = 0, l = results.length; i < l; i++ ) { - if ( results[i].getAttribute("name") === match[1] ) { - ret.push( results[i] ); - } - } - - return ret.length === 0 ? null : ret; - } - }, - - TAG: function( match, context ) { - if ( typeof context.getElementsByTagName !== "undefined" ) { - return context.getElementsByTagName( match[1] ); - } - } - }, - preFilter: { - CLASS: function( match, curLoop, inplace, result, not, isXML ) { - match = " " + match[1].replace( rBackslash, "" ) + " "; - - if ( isXML ) { - return match; - } - - for ( var i = 0, elem; (elem = curLoop[i]) != null; i++ ) { - if ( elem ) { - if ( not ^ (elem.className && (" " + elem.className + " ").replace(/[\t\n\r]/g, " ").indexOf(match) >= 0) ) { - if ( !inplace ) { - result.push( elem ); - } - - } else if ( inplace ) { - curLoop[i] = false; - } - } - } - - return false; - }, - - ID: function( match ) { - return match[1].replace( rBackslash, "" ); - }, - - TAG: function( match, curLoop ) { - return match[1].replace( rBackslash, "" ).toLowerCase(); - }, - - CHILD: function( match ) { - if ( match[1] === "nth" ) { - if ( !match[2] ) { - Sizzle.error( match[0] ); - } - - match[2] = match[2].replace(/^\+|\s*/g, ''); - - // parse equations like 'even', 'odd', '5', '2n', '3n+2', '4n-1', '-n+6' - var test = /(-?)(\d*)(?:n([+\-]?\d*))?/.exec( - match[2] === "even" && "2n" || match[2] === "odd" && "2n+1" || - !/\D/.test( match[2] ) && "0n+" + match[2] || match[2]); - - // calculate the numbers (first)n+(last) including if they are negative - match[2] = (test[1] + (test[2] || 1)) - 0; - match[3] = test[3] - 0; - } - else if ( match[2] ) { - Sizzle.error( match[0] ); - } - - // TODO: Move to normal caching system - match[0] = done++; - - return match; - }, - - ATTR: function( match, curLoop, inplace, result, not, isXML ) { - var name = match[1] = match[1].replace( rBackslash, "" ); - - if ( !isXML && Expr.attrMap[name] ) { - match[1] = Expr.attrMap[name]; - } - - // Handle if an un-quoted value was used - match[4] = ( match[4] || match[5] || "" ).replace( rBackslash, "" ); - - if ( match[2] === "~=" ) { - match[4] = " " + match[4] + " "; - } - - return match; - }, - - PSEUDO: function( match, curLoop, inplace, result, not ) { - if ( match[1] === "not" ) { - // If we're dealing with a complex expression, or a simple one - if ( ( chunker.exec(match[3]) || "" ).length > 1 || /^\w/.test(match[3]) ) { - match[3] = Sizzle(match[3], null, null, curLoop); - - } else { - var ret = Sizzle.filter(match[3], curLoop, inplace, true ^ not); - - if ( !inplace ) { - result.push.apply( result, ret ); - } - - return false; - } - - } else if ( Expr.match.POS.test( match[0] ) || Expr.match.CHILD.test( match[0] ) ) { - return true; - } - - return match; - }, - - POS: function( match ) { - match.unshift( true ); - - return match; - } - }, - - filters: { - enabled: function( elem ) { - return elem.disabled === false && elem.type !== "hidden"; - }, - - disabled: function( elem ) { - return elem.disabled === true; - }, - - checked: function( elem ) { - return elem.checked === true; - }, - - selected: function( elem ) { - // Accessing this property makes selected-by-default - // options in Safari work properly - if ( elem.parentNode ) { - elem.parentNode.selectedIndex; - } - - return elem.selected === true; - }, - - parent: function( elem ) { - return !!elem.firstChild; - }, - - empty: function( elem ) { - return !elem.firstChild; - }, - - has: function( elem, i, match ) { - return !!Sizzle( match[3], elem ).length; - }, - - header: function( elem ) { - return (/h\d/i).test( elem.nodeName ); - }, - - text: function( elem ) { - var attr = elem.getAttribute( "type" ), type = elem.type; - // IE6 and 7 will map elem.type to 'text' for new HTML5 types (search, etc) - // use getAttribute instead to test this case - return elem.nodeName.toLowerCase() === "input" && "text" === type && ( attr === type || attr === null ); - }, - - radio: function( elem ) { - return elem.nodeName.toLowerCase() === "input" && "radio" === elem.type; - }, - - checkbox: function( elem ) { - return elem.nodeName.toLowerCase() === "input" && "checkbox" === elem.type; - }, - - file: function( elem ) { - return elem.nodeName.toLowerCase() === "input" && "file" === elem.type; - }, - - password: function( elem ) { - return elem.nodeName.toLowerCase() === "input" && "password" === elem.type; - }, - - submit: function( elem ) { - var name = elem.nodeName.toLowerCase(); - return (name === "input" || name === "button") && "submit" === elem.type; - }, - - image: function( elem ) { - return elem.nodeName.toLowerCase() === "input" && "image" === elem.type; - }, - - reset: function( elem ) { - var name = elem.nodeName.toLowerCase(); - return (name === "input" || name === "button") && "reset" === elem.type; - }, - - button: function( elem ) { - var name = elem.nodeName.toLowerCase(); - return name === "input" && "button" === elem.type || name === "button"; - }, - - input: function( elem ) { - return (/input|select|textarea|button/i).test( elem.nodeName ); - }, - - focus: function( elem ) { - return elem === elem.ownerDocument.activeElement; - } - }, - setFilters: { - first: function( elem, i ) { - return i === 0; - }, - - last: function( elem, i, match, array ) { - return i === array.length - 1; - }, - - even: function( elem, i ) { - return i % 2 === 0; - }, - - odd: function( elem, i ) { - return i % 2 === 1; - }, - - lt: function( elem, i, match ) { - return i < match[3] - 0; - }, - - gt: function( elem, i, match ) { - return i > match[3] - 0; - }, - - nth: function( elem, i, match ) { - return match[3] - 0 === i; - }, - - eq: function( elem, i, match ) { - return match[3] - 0 === i; - } - }, - filter: { - PSEUDO: function( elem, match, i, array ) { - var name = match[1], - filter = Expr.filters[ name ]; - - if ( filter ) { - return filter( elem, i, match, array ); - - } else if ( name === "contains" ) { - return (elem.textContent || elem.innerText || Sizzle.getText([ elem ]) || "").indexOf(match[3]) >= 0; - - } else if ( name === "not" ) { - var not = match[3]; - - for ( var j = 0, l = not.length; j < l; j++ ) { - if ( not[j] === elem ) { - return false; - } - } - - return true; - - } else { - Sizzle.error( name ); - } - }, - - CHILD: function( elem, match ) { - var type = match[1], - node = elem; - - switch ( type ) { - case "only": - case "first": - while ( (node = node.previousSibling) ) { - if ( node.nodeType === 1 ) { - return false; - } - } - - if ( type === "first" ) { - return true; - } - - node = elem; - - case "last": - while ( (node = node.nextSibling) ) { - if ( node.nodeType === 1 ) { - return false; - } - } - - return true; - - case "nth": - var first = match[2], - last = match[3]; - - if ( first === 1 && last === 0 ) { - return true; - } - - var doneName = match[0], - parent = elem.parentNode; - - if ( parent && (parent.sizcache !== doneName || !elem.nodeIndex) ) { - var count = 0; - - for ( node = parent.firstChild; node; node = node.nextSibling ) { - if ( node.nodeType === 1 ) { - node.nodeIndex = ++count; - } - } - - parent.sizcache = doneName; - } - - var diff = elem.nodeIndex - last; - - if ( first === 0 ) { - return diff === 0; - - } else { - return ( diff % first === 0 && diff / first >= 0 ); - } - } - }, - - ID: function( elem, match ) { - return elem.nodeType === 1 && elem.getAttribute("id") === match; - }, - - TAG: function( elem, match ) { - return (match === "*" && elem.nodeType === 1) || elem.nodeName.toLowerCase() === match; - }, - - CLASS: function( elem, match ) { - return (" " + (elem.className || elem.getAttribute("class")) + " ") - .indexOf( match ) > -1; - }, - - ATTR: function( elem, match ) { - var name = match[1], - result = Expr.attrHandle[ name ] ? - Expr.attrHandle[ name ]( elem ) : - elem[ name ] != null ? - elem[ name ] : - elem.getAttribute( name ), - value = result + "", - type = match[2], - check = match[4]; - - return result == null ? - type === "!=" : - type === "=" ? - value === check : - type === "*=" ? - value.indexOf(check) >= 0 : - type === "~=" ? - (" " + value + " ").indexOf(check) >= 0 : - !check ? - value && result !== false : - type === "!=" ? - value !== check : - type === "^=" ? - value.indexOf(check) === 0 : - type === "$=" ? - value.substr(value.length - check.length) === check : - type === "|=" ? - value === check || value.substr(0, check.length + 1) === check + "-" : - false; - }, - - POS: function( elem, match, i, array ) { - var name = match[2], - filter = Expr.setFilters[ name ]; - - if ( filter ) { - return filter( elem, i, match, array ); - } - } - } -}; - -var origPOS = Expr.match.POS, - fescape = function(all, num){ - return "\\" + (num - 0 + 1); - }; - -for ( var type in Expr.match ) { - Expr.match[ type ] = new RegExp( Expr.match[ type ].source + (/(?![^\[]*\])(?![^\(]*\))/.source) ); - Expr.leftMatch[ type ] = new RegExp( /(^(?:.|\r|\n)*?)/.source + Expr.match[ type ].source.replace(/\\(\d+)/g, fescape) ); -} - -var makeArray = function( array, results ) { - array = Array.prototype.slice.call( array, 0 ); - - if ( results ) { - results.push.apply( results, array ); - return results; - } - - return array; -}; - -// Perform a simple check to determine if the browser is capable of -// converting a NodeList to an array using builtin methods. -// Also verifies that the returned array holds DOM nodes -// (which is not the case in the Blackberry browser) -try { - Array.prototype.slice.call( document.documentElement.childNodes, 0 )[0].nodeType; - -// Provide a fallback method if it does not work -} catch( e ) { - makeArray = function( array, results ) { - var i = 0, - ret = results || []; - - if ( toString.call(array) === "[object Array]" ) { - Array.prototype.push.apply( ret, array ); - - } else { - if ( typeof array.length === "number" ) { - for ( var l = array.length; i < l; i++ ) { - ret.push( array[i] ); - } - - } else { - for ( ; array[i]; i++ ) { - ret.push( array[i] ); - } - } - } - - return ret; - }; -} - -var sortOrder, siblingCheck; - -if ( document.documentElement.compareDocumentPosition ) { - sortOrder = function( a, b ) { - if ( a === b ) { - hasDuplicate = true; - return 0; - } - - if ( !a.compareDocumentPosition || !b.compareDocumentPosition ) { - return a.compareDocumentPosition ? -1 : 1; - } - - return a.compareDocumentPosition(b) & 4 ? -1 : 1; - }; - -} else { - sortOrder = function( a, b ) { - // The nodes are identical, we can exit early - if ( a === b ) { - hasDuplicate = true; - return 0; - - // Fallback to using sourceIndex (in IE) if it's available on both nodes - } else if ( a.sourceIndex && b.sourceIndex ) { - return a.sourceIndex - b.sourceIndex; - } - - var al, bl, - ap = [], - bp = [], - aup = a.parentNode, - bup = b.parentNode, - cur = aup; - - // If the nodes are siblings (or identical) we can do a quick check - if ( aup === bup ) { - return siblingCheck( a, b ); - - // If no parents were found then the nodes are disconnected - } else if ( !aup ) { - return -1; - - } else if ( !bup ) { - return 1; - } - - // Otherwise they're somewhere else in the tree so we need - // to build up a full list of the parentNodes for comparison - while ( cur ) { - ap.unshift( cur ); - cur = cur.parentNode; - } - - cur = bup; - - while ( cur ) { - bp.unshift( cur ); - cur = cur.parentNode; - } - - al = ap.length; - bl = bp.length; - - // Start walking down the tree looking for a discrepancy - for ( var i = 0; i < al && i < bl; i++ ) { - if ( ap[i] !== bp[i] ) { - return siblingCheck( ap[i], bp[i] ); - } - } - - // We ended someplace up the tree so do a sibling check - return i === al ? - siblingCheck( a, bp[i], -1 ) : - siblingCheck( ap[i], b, 1 ); - }; - - siblingCheck = function( a, b, ret ) { - if ( a === b ) { - return ret; - } - - var cur = a.nextSibling; - - while ( cur ) { - if ( cur === b ) { - return -1; - } - - cur = cur.nextSibling; - } - - return 1; - }; -} - -// Utility function for retreiving the text value of an array of DOM nodes -Sizzle.getText = function( elems ) { - var ret = "", elem; - - for ( var i = 0; elems[i]; i++ ) { - elem = elems[i]; - - // Get the text from text nodes and CDATA nodes - if ( elem.nodeType === 3 || elem.nodeType === 4 ) { - ret += elem.nodeValue; - - // Traverse everything else, except comment nodes - } else if ( elem.nodeType !== 8 ) { - ret += Sizzle.getText( elem.childNodes ); - } - } - - return ret; -}; - -// Check to see if the browser returns elements by name when -// querying by getElementById (and provide a workaround) -(function(){ - // We're going to inject a fake input element with a specified name - var form = document.createElement("div"), - id = "script" + (new Date()).getTime(), - root = document.documentElement; - - form.innerHTML = ""; - - // Inject it into the root element, check its status, and remove it quickly - root.insertBefore( form, root.firstChild ); - - // The workaround has to do additional checks after a getElementById - // Which slows things down for other browsers (hence the branching) - if ( document.getElementById( id ) ) { - Expr.find.ID = function( match, context, isXML ) { - if ( typeof context.getElementById !== "undefined" && !isXML ) { - var m = context.getElementById(match[1]); - - return m ? - m.id === match[1] || typeof m.getAttributeNode !== "undefined" && m.getAttributeNode("id").nodeValue === match[1] ? - [m] : - undefined : - []; - } - }; - - Expr.filter.ID = function( elem, match ) { - var node = typeof elem.getAttributeNode !== "undefined" && elem.getAttributeNode("id"); - - return elem.nodeType === 1 && node && node.nodeValue === match; - }; - } - - root.removeChild( form ); - - // release memory in IE - root = form = null; -})(); - -(function(){ - // Check to see if the browser returns only elements - // when doing getElementsByTagName("*") - - // Create a fake element - var div = document.createElement("div"); - div.appendChild( document.createComment("") ); - - // Make sure no comments are found - if ( div.getElementsByTagName("*").length > 0 ) { - Expr.find.TAG = function( match, context ) { - var results = context.getElementsByTagName( match[1] ); - - // Filter out possible comments - if ( match[1] === "*" ) { - var tmp = []; - - for ( var i = 0; results[i]; i++ ) { - if ( results[i].nodeType === 1 ) { - tmp.push( results[i] ); - } - } - - results = tmp; - } - - return results; - }; - } - - // Check to see if an attribute returns normalized href attributes - div.innerHTML = ""; - - if ( div.firstChild && typeof div.firstChild.getAttribute !== "undefined" && - div.firstChild.getAttribute("href") !== "#" ) { - - Expr.attrHandle.href = function( elem ) { - return elem.getAttribute( "href", 2 ); - }; - } - - // release memory in IE - div = null; -})(); - -if ( document.querySelectorAll ) { - (function(){ - var oldSizzle = Sizzle, - div = document.createElement("div"), - id = "__sizzle__"; - - div.innerHTML = "

"; - - // Safari can't handle uppercase or unicode characters when - // in quirks mode. - if ( div.querySelectorAll && div.querySelectorAll(".TEST").length === 0 ) { - return; - } - - Sizzle = function( query, context, extra, seed ) { - context = context || document; - - // Only use querySelectorAll on non-XML documents - // (ID selectors don't work in non-HTML documents) - if ( !seed && !Sizzle.isXML(context) ) { - // See if we find a selector to speed up - var match = /^(\w+$)|^\.([\w\-]+$)|^#([\w\-]+$)/.exec( query ); - - if ( match && (context.nodeType === 1 || context.nodeType === 9) ) { - // Speed-up: Sizzle("TAG") - if ( match[1] ) { - return makeArray( context.getElementsByTagName( query ), extra ); - - // Speed-up: Sizzle(".CLASS") - } else if ( match[2] && Expr.find.CLASS && context.getElementsByClassName ) { - return makeArray( context.getElementsByClassName( match[2] ), extra ); - } - } - - if ( context.nodeType === 9 ) { - // Speed-up: Sizzle("body") - // The body element only exists once, optimize finding it - if ( query === "body" && context.body ) { - return makeArray( [ context.body ], extra ); - - // Speed-up: Sizzle("#ID") - } else if ( match && match[3] ) { - var elem = context.getElementById( match[3] ); - - // Check parentNode to catch when Blackberry 4.6 returns - // nodes that are no longer in the document #6963 - if ( elem && elem.parentNode ) { - // Handle the case where IE and Opera return items - // by name instead of ID - if ( elem.id === match[3] ) { - return makeArray( [ elem ], extra ); - } - - } else { - return makeArray( [], extra ); - } - } - - try { - return makeArray( context.querySelectorAll(query), extra ); - } catch(qsaError) {} - - // qSA works strangely on Element-rooted queries - // We can work around this by specifying an extra ID on the root - // and working up from there (Thanks to Andrew Dupont for the technique) - // IE 8 doesn't work on object elements - } else if ( context.nodeType === 1 && context.nodeName.toLowerCase() !== "object" ) { - var oldContext = context, - old = context.getAttribute( "id" ), - nid = old || id, - hasParent = context.parentNode, - relativeHierarchySelector = /^\s*[+~]/.test( query ); - - if ( !old ) { - context.setAttribute( "id", nid ); - } else { - nid = nid.replace( /'/g, "\\$&" ); - } - if ( relativeHierarchySelector && hasParent ) { - context = context.parentNode; - } - - try { - if ( !relativeHierarchySelector || hasParent ) { - return makeArray( context.querySelectorAll( "[id='" + nid + "'] " + query ), extra ); - } - - } catch(pseudoError) { - } finally { - if ( !old ) { - oldContext.removeAttribute( "id" ); - } - } - } - } - - return oldSizzle(query, context, extra, seed); - }; - - for ( var prop in oldSizzle ) { - Sizzle[ prop ] = oldSizzle[ prop ]; - } - - // release memory in IE - div = null; - })(); -} - -(function(){ - var html = document.documentElement, - matches = html.matchesSelector || html.mozMatchesSelector || html.webkitMatchesSelector || html.msMatchesSelector; - - if ( matches ) { - // Check to see if it's possible to do matchesSelector - // on a disconnected node (IE 9 fails this) - var disconnectedMatch = !matches.call( document.createElement( "div" ), "div" ), - pseudoWorks = false; - - try { - // This should fail with an exception - // Gecko does not error, returns false instead - matches.call( document.documentElement, "[test!='']:sizzle" ); - - } catch( pseudoError ) { - pseudoWorks = true; - } - - Sizzle.matchesSelector = function( node, expr ) { - // Make sure that attribute selectors are quoted - expr = expr.replace(/\=\s*([^'"\]]*)\s*\]/g, "='$1']"); - - if ( !Sizzle.isXML( node ) ) { - try { - if ( pseudoWorks || !Expr.match.PSEUDO.test( expr ) && !/!=/.test( expr ) ) { - var ret = matches.call( node, expr ); - - // IE 9's matchesSelector returns false on disconnected nodes - if ( ret || !disconnectedMatch || - // As well, disconnected nodes are said to be in a document - // fragment in IE 9, so check for that - node.document && node.document.nodeType !== 11 ) { - return ret; - } - } - } catch(e) {} - } - - return Sizzle(expr, null, null, [node]).length > 0; - }; - } -})(); - -(function(){ - var div = document.createElement("div"); - - div.innerHTML = "
"; - - // Opera can't find a second classname (in 9.6) - // Also, make sure that getElementsByClassName actually exists - if ( !div.getElementsByClassName || div.getElementsByClassName("e").length === 0 ) { - return; - } - - // Safari caches class attributes, doesn't catch changes (in 3.2) - div.lastChild.className = "e"; - - if ( div.getElementsByClassName("e").length === 1 ) { - return; - } - - Expr.order.splice(1, 0, "CLASS"); - Expr.find.CLASS = function( match, context, isXML ) { - if ( typeof context.getElementsByClassName !== "undefined" && !isXML ) { - return context.getElementsByClassName(match[1]); - } - }; - - // release memory in IE - div = null; -})(); - -function dirNodeCheck( dir, cur, doneName, checkSet, nodeCheck, isXML ) { - for ( var i = 0, l = checkSet.length; i < l; i++ ) { - var elem = checkSet[i]; - - if ( elem ) { - var match = false; - - elem = elem[dir]; - - while ( elem ) { - if ( elem.sizcache === doneName ) { - match = checkSet[elem.sizset]; - break; - } - - if ( elem.nodeType === 1 && !isXML ){ - elem.sizcache = doneName; - elem.sizset = i; - } - - if ( elem.nodeName.toLowerCase() === cur ) { - match = elem; - break; - } - - elem = elem[dir]; - } - - checkSet[i] = match; - } - } -} - -function dirCheck( dir, cur, doneName, checkSet, nodeCheck, isXML ) { - for ( var i = 0, l = checkSet.length; i < l; i++ ) { - var elem = checkSet[i]; - - if ( elem ) { - var match = false; - - elem = elem[dir]; - - while ( elem ) { - if ( elem.sizcache === doneName ) { - match = checkSet[elem.sizset]; - break; - } - - if ( elem.nodeType === 1 ) { - if ( !isXML ) { - elem.sizcache = doneName; - elem.sizset = i; - } - - if ( typeof cur !== "string" ) { - if ( elem === cur ) { - match = true; - break; - } - - } else if ( Sizzle.filter( cur, [elem] ).length > 0 ) { - match = elem; - break; - } - } - - elem = elem[dir]; - } - - checkSet[i] = match; - } - } -} - -if ( document.documentElement.contains ) { - Sizzle.contains = function( a, b ) { - return a !== b && (a.contains ? a.contains(b) : true); - }; - -} else if ( document.documentElement.compareDocumentPosition ) { - Sizzle.contains = function( a, b ) { - return !!(a.compareDocumentPosition(b) & 16); - }; - -} else { - Sizzle.contains = function() { - return false; - }; -} - -Sizzle.isXML = function( elem ) { - // documentElement is verified for cases where it doesn't yet exist - // (such as loading iframes in IE - #4833) - var documentElement = (elem ? elem.ownerDocument || elem : 0).documentElement; - - return documentElement ? documentElement.nodeName !== "HTML" : false; -}; - -var posProcess = function( selector, context ) { - var match, - tmpSet = [], - later = "", - root = context.nodeType ? [context] : context; - - // Position selectors must be done after the filter - // And so must :not(positional) so we move all PSEUDOs to the end - while ( (match = Expr.match.PSEUDO.exec( selector )) ) { - later += match[0]; - selector = selector.replace( Expr.match.PSEUDO, "" ); - } - - selector = Expr.relative[selector] ? selector + "*" : selector; - - for ( var i = 0, l = root.length; i < l; i++ ) { - Sizzle( selector, root[i], tmpSet ); - } - - return Sizzle.filter( later, tmpSet ); -}; - -// EXPOSE -jQuery.find = Sizzle; -jQuery.expr = Sizzle.selectors; -jQuery.expr[":"] = jQuery.expr.filters; -jQuery.unique = Sizzle.uniqueSort; -jQuery.text = Sizzle.getText; -jQuery.isXMLDoc = Sizzle.isXML; -jQuery.contains = Sizzle.contains; - - -})(); - - -var runtil = /Until$/, - rparentsprev = /^(?:parents|prevUntil|prevAll)/, - // Note: This RegExp should be improved, or likely pulled from Sizzle - rmultiselector = /,/, - isSimple = /^.[^:#\[\.,]*$/, - slice = Array.prototype.slice, - POS = jQuery.expr.match.POS, - // methods guaranteed to produce a unique set when starting from a unique set - guaranteedUnique = { - children: true, - contents: true, - next: true, - prev: true - }; - -jQuery.fn.extend({ - find: function( selector ) { - var self = this, - i, l; - - if ( typeof selector !== "string" ) { - return jQuery( selector ).filter(function() { - for ( i = 0, l = self.length; i < l; i++ ) { - if ( jQuery.contains( self[ i ], this ) ) { - return true; - } - } - }); - } - - var ret = this.pushStack( "", "find", selector ), - length, n, r; - - for ( i = 0, l = this.length; i < l; i++ ) { - length = ret.length; - jQuery.find( selector, this[i], ret ); - - if ( i > 0 ) { - // Make sure that the results are unique - for ( n = length; n < ret.length; n++ ) { - for ( r = 0; r < length; r++ ) { - if ( ret[r] === ret[n] ) { - ret.splice(n--, 1); - break; - } - } - } - } - } - - return ret; - }, - - has: function( target ) { - var targets = jQuery( target ); - return this.filter(function() { - for ( var i = 0, l = targets.length; i < l; i++ ) { - if ( jQuery.contains( this, targets[i] ) ) { - return true; - } - } - }); - }, - - not: function( selector ) { - return this.pushStack( winnow(this, selector, false), "not", selector); - }, - - filter: function( selector ) { - return this.pushStack( winnow(this, selector, true), "filter", selector ); - }, - - is: function( selector ) { - return !!selector && ( typeof selector === "string" ? - jQuery.filter( selector, this ).length > 0 : - this.filter( selector ).length > 0 ); - }, - - closest: function( selectors, context ) { - var ret = [], i, l, cur = this[0]; - - // Array - if ( jQuery.isArray( selectors ) ) { - var match, selector, - matches = {}, - level = 1; - - if ( cur && selectors.length ) { - for ( i = 0, l = selectors.length; i < l; i++ ) { - selector = selectors[i]; - - if ( !matches[ selector ] ) { - matches[ selector ] = POS.test( selector ) ? - jQuery( selector, context || this.context ) : - selector; - } - } - - while ( cur && cur.ownerDocument && cur !== context ) { - for ( selector in matches ) { - match = matches[ selector ]; - - if ( match.jquery ? match.index( cur ) > -1 : jQuery( cur ).is( match ) ) { - ret.push({ selector: selector, elem: cur, level: level }); - } - } - - cur = cur.parentNode; - level++; - } - } - - return ret; - } - - // String - var pos = POS.test( selectors ) || typeof selectors !== "string" ? - jQuery( selectors, context || this.context ) : - 0; - - for ( i = 0, l = this.length; i < l; i++ ) { - cur = this[i]; - - while ( cur ) { - if ( pos ? pos.index(cur) > -1 : jQuery.find.matchesSelector(cur, selectors) ) { - ret.push( cur ); - break; - - } else { - cur = cur.parentNode; - if ( !cur || !cur.ownerDocument || cur === context || cur.nodeType === 11 ) { - break; - } - } - } - } - - ret = ret.length > 1 ? jQuery.unique( ret ) : ret; - - return this.pushStack( ret, "closest", selectors ); - }, - - // Determine the position of an element within - // the matched set of elements - index: function( elem ) { - - // No argument, return index in parent - if ( !elem ) { - return ( this[0] && this[0].parentNode ) ? this.prevAll().length : -1; - } - - // index in selector - if ( typeof elem === "string" ) { - return jQuery.inArray( this[0], jQuery( elem ) ); - } - - // Locate the position of the desired element - return jQuery.inArray( - // If it receives a jQuery object, the first element is used - elem.jquery ? elem[0] : elem, this ); - }, - - add: function( selector, context ) { - var set = typeof selector === "string" ? - jQuery( selector, context ) : - jQuery.makeArray( selector && selector.nodeType ? [ selector ] : selector ), - all = jQuery.merge( this.get(), set ); - - return this.pushStack( isDisconnected( set[0] ) || isDisconnected( all[0] ) ? - all : - jQuery.unique( all ) ); - }, - - andSelf: function() { - return this.add( this.prevObject ); - } -}); - -// A painfully simple check to see if an element is disconnected -// from a document (should be improved, where feasible). -function isDisconnected( node ) { - return !node || !node.parentNode || node.parentNode.nodeType === 11; -} - -jQuery.each({ - parent: function( elem ) { - var parent = elem.parentNode; - return parent && parent.nodeType !== 11 ? parent : null; - }, - parents: function( elem ) { - return jQuery.dir( elem, "parentNode" ); - }, - parentsUntil: function( elem, i, until ) { - return jQuery.dir( elem, "parentNode", until ); - }, - next: function( elem ) { - return jQuery.nth( elem, 2, "nextSibling" ); - }, - prev: function( elem ) { - return jQuery.nth( elem, 2, "previousSibling" ); - }, - nextAll: function( elem ) { - return jQuery.dir( elem, "nextSibling" ); - }, - prevAll: function( elem ) { - return jQuery.dir( elem, "previousSibling" ); - }, - nextUntil: function( elem, i, until ) { - return jQuery.dir( elem, "nextSibling", until ); - }, - prevUntil: function( elem, i, until ) { - return jQuery.dir( elem, "previousSibling", until ); - }, - siblings: function( elem ) { - return jQuery.sibling( elem.parentNode.firstChild, elem ); - }, - children: function( elem ) { - return jQuery.sibling( elem.firstChild ); - }, - contents: function( elem ) { - return jQuery.nodeName( elem, "iframe" ) ? - elem.contentDocument || elem.contentWindow.document : - jQuery.makeArray( elem.childNodes ); - } -}, function( name, fn ) { - jQuery.fn[ name ] = function( until, selector ) { - var ret = jQuery.map( this, fn, until ), - // The variable 'args' was introduced in - // https://github.com/jquery/jquery/commit/52a0238 - // to work around a bug in Chrome 10 (Dev) and should be removed when the bug is fixed. - // http://code.google.com/p/v8/issues/detail?id=1050 - args = slice.call(arguments); - - if ( !runtil.test( name ) ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - ret = jQuery.filter( selector, ret ); - } - - ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; - - if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { - ret = ret.reverse(); - } - - return this.pushStack( ret, name, args.join(",") ); - }; -}); - -jQuery.extend({ - filter: function( expr, elems, not ) { - if ( not ) { - expr = ":not(" + expr + ")"; - } - - return elems.length === 1 ? - jQuery.find.matchesSelector(elems[0], expr) ? [ elems[0] ] : [] : - jQuery.find.matches(expr, elems); - }, - - dir: function( elem, dir, until ) { - var matched = [], - cur = elem[ dir ]; - - while ( cur && cur.nodeType !== 9 && (until === undefined || cur.nodeType !== 1 || !jQuery( cur ).is( until )) ) { - if ( cur.nodeType === 1 ) { - matched.push( cur ); - } - cur = cur[dir]; - } - return matched; - }, - - nth: function( cur, result, dir, elem ) { - result = result || 1; - var num = 0; - - for ( ; cur; cur = cur[dir] ) { - if ( cur.nodeType === 1 && ++num === result ) { - break; - } - } - - return cur; - }, - - sibling: function( n, elem ) { - var r = []; - - for ( ; n; n = n.nextSibling ) { - if ( n.nodeType === 1 && n !== elem ) { - r.push( n ); - } - } - - return r; - } -}); - -// Implement the identical functionality for filter and not -function winnow( elements, qualifier, keep ) { - - // Can't pass null or undefined to indexOf in Firefox 4 - // Set to 0 to skip string check - qualifier = qualifier || 0; - - if ( jQuery.isFunction( qualifier ) ) { - return jQuery.grep(elements, function( elem, i ) { - var retVal = !!qualifier.call( elem, i, elem ); - return retVal === keep; - }); - - } else if ( qualifier.nodeType ) { - return jQuery.grep(elements, function( elem, i ) { - return (elem === qualifier) === keep; - }); - - } else if ( typeof qualifier === "string" ) { - var filtered = jQuery.grep(elements, function( elem ) { - return elem.nodeType === 1; - }); - - if ( isSimple.test( qualifier ) ) { - return jQuery.filter(qualifier, filtered, !keep); - } else { - qualifier = jQuery.filter( qualifier, filtered ); - } - } - - return jQuery.grep(elements, function( elem, i ) { - return (jQuery.inArray( elem, qualifier ) >= 0) === keep; - }); -} - - - - -var rinlinejQuery = / jQuery\d+="(?:\d+|null)"/g, - rleadingWhitespace = /^\s+/, - rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig, - rtagName = /<([\w:]+)/, - rtbody = /", "" ], - legend: [ 1, "
", "
" ], - thead: [ 1, "", "
" ], - tr: [ 2, "", "
" ], - td: [ 3, "", "
" ], - col: [ 2, "", "
" ], - area: [ 1, "", "" ], - _default: [ 0, "", "" ] - }; - -wrapMap.optgroup = wrapMap.option; -wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; -wrapMap.th = wrapMap.td; - -// IE can't serialize and