JetBrains.Platform.Util @param purpose What id will be used for, shouldn't be empty. @return Anonymized machine id or null If getting machine id was failed. Reads machineId from /etc/machine-id or if not found from /var/lib/dbus/machine-id See https://manpages.debian.org/testing/systemd/machine-id.5.en.html for more details Invokes `ioreg -rd1 -c IOPlatformExpertDevice` to get IOPlatformUUID A lazily-calculated asynchronous value. Lazily-created task. Threading: simple reads, CAS writes. An explicit value. A function to produce the value. This function is run within a task when the value is requested. A function to produce the value. This function is run within a task when the value is requested. An async lambda. Inheritor ctor for custom lazy init. Expected to override in the inheritor to provide the value if this overload is used. Gets an awaiter used to await this . An awaiter instance. Starts calculating the value asynchronously, if this is the first time the value has been called for. Returns the task to be awaited. On subsequent calls, returns the same task (either completed or not). Cold-path for to initiate its calculation. Skipped on further calls. Override in derived classes to avoid creating a ctor-passed lambda. Replaces the factory constructor parameter. This WILL NOT be called from the base ctor. This will be called: 1) Never, if the user never asks for the lazy task. 2) Once, the first time the user asks for the lazy task, if this method succeeds. 3) If this method throws, then each next time the user asks for the lazy task, until it succeeds. Avoid boxing boolean by reusing the boxes for readonly purposes. This is a quick index for the NetFX Reference Assemblies set, by taking the first word out of their names, as listed within the Microsoft.NETFramework.ReferenceAssemblies.net472 package v1.0.3. Sorted lexicographically, case-insensitively. When building part catalogs, these assemblies are (a) expected to be missing on runtimes other than NetFX; (b) are safe to skip because they cannot have an attribute which would mark a type as catalogable. Stores last know information about file path (last write time, file attributes etc.) Creates data by location. The method will access file system to read actual data. Use the overload if you have the data available to reduce performance penalty File location Creates the data by the values obtained somehow Last write time UTC File attributes Whether file exists File length in bytes Last access time UTC Creation time UTC Creates the data by the Directory entry data obtained by LocalVirtualFileSystemInteraction.GetDirectoryEntries overloads This sorting algorithm logically handles numbers in strings. It makes sense to humans. Highway names like 50F and 100F will be sorted wrongly with ASCII sort. https://www.dotnetperls.com/alphanumeric-sorting Multiset, each element can be included into set multiple times. Internally implemented as Dictionary : [Element] -> [Number of equal elements in this set] Each time we execute with positive value counter for given element is increased. On or with negative value counter is decreased (if it becomes zero, element is removed from set). You can check the number of element occurrences in this set by invoking Type of set's element Internally implemented as HashMap : [Element] -> [Number of equal elements (possible negative number)] Each time we execute or with positive value counter for given element is increased (if it becomes zero, element is removed from set). On or with negative value counter is decreased (if it becomes zero, element is removed from set). You can check the number of element occurrences in this set by invoking Type of set's element This class adapts to read-only involving count of items. Methods and are not supported. Used to optimize getting count of items only. Count is specified in constructor - it IS NOT counted automatically by enumerable. The type of the elements in the collection. Class contains classic methods of for . One of purposes is to suport "struct enumerators" - all theese methods works with "struct enumerators" without allocating any object in the heap. Factory for anonymous implementations based on delegates provided. Returns equality comparer implementation from pair of delegates. Returns equality comparer implementation projecting values to some keys using the delegate rule provided and comparing those keys with custom or default equality comparer for key type. Returns the equality comparer that compares two instances structurally, meaning items at equal indexes to equal (using the to compare items). Returns the equality comparer that compares two instances structurally, meaning items at equal indexes to equal (using the to compare items). Returns the equality comparer that compares two instances structurally, meaning items at equal indexes to equal (using the to compare items). Red-black tree implementation. Not thread-safe Sorted map, can be used for imprecise search Creates an instance of this class. The number of nodes contained in the tree. Clears the tree. Returns true if the tree is empty. Returns the minimum key value. Returns the maximum key value. Returns the object having the minimum key value. Returns the object having the maximum key. Gets node for the specified key or null if not found. WARNING: This is hackish. Use it only when you really need it and understand all side-effects. Gets node associated with largest key less than or equal to the given key or null if not found. WARNING: This is hackish. Use it only when you really need it and understand all side-effects. Gets node associated with smallest key greater than or equal to the given key or null if not found. WARNING: This is hackish. Use it only when you really need it and understand all side-effects. Gets node for the specified key, throws if not found. WARNING: This is hackish. Use it only when you really need it and understand all side-effects. Gets the data object associated with the specified key. Gets the data object associated with largest key less than or equal to the given key. Gets the data object associated with the smallest key greater than or equal to the given key. This method updates key and value for existing node. WARNING: It doesn't check that replaced key is in correct place! Use this method only if you are shifting keys and you're sure that this won't cause any corruption to the tree! Rebalance the tree by rotating the nodes to the left. Rebalance the tree by rotating the nodes to the right. Removes the key and data object (delete). Returns an enumerator that returns nodes in order. Returns keys in order as specified in parameter. Returns all the values in the tree in order as specified in the parameter. Returns an enumerator that iterates through a collection. Returns an enumeration of the data objects in order as specified in the parameter. RestoreAfterInsert Additions to red-black trees usually destroy the red-black properties. Examine the tree and restore. Rotations are normally required to restore it Deletions from red-black trees may destroy the red-black properties. Examine the tree and restore. Rotations are normally required to restore it. Deletes a node from the tree and restores red black properties. Creates a new object that is a copy of the current instance. A new object that is a copy of this instance. 2 Returns an enumerator that returns the key-value pairs in order. The JetBinaryTreeEnumerator class returns the keys or data objects of the treap in sorted order. Determine order, walk the tree and push the nodes onto the stack Key. The data or value associated with the key. The data or value associated with the key. Use depth-first traversal to push nodes into stack the lowest node will be at the top of the stack. Next element. Has more elements. Move next. A single node that is encapsulated in a red black tree data structure. Creates an instance of this class. Color - used to balance the tree. Left node. Right node. Parent node. Key provided by the calling class. Data available in this node A node in a red black tree can have one of the following two colors. Works only with range lists where ranges cannot strictly intersect with each other and that are normalized Factory for anonymous implementations based on delegates provided. Returns equality comparer implementation projecting values to some keys using the delegate rule provided and comparing those keys with custom or default equality comparer for key type. Returns equality comparer implementation from pair of delegates. Cache of most recently used items. No position update on access. All methods of this class are thread safe > The type of the entities in the pool Gets an object from the pool. Object is returned to the pool as lifetime is terminated. If there are no vacant objects the new one is created using the factory passed to the constructor Lifetime of the object using, terminate it when finish using of the object in order to return it to the pool Return an object from the pool Gets an object from the pool. Object must be returned to the pool via method. If there are no vacant objects the new one is created using the factory passed to the constructor Return an object from the pool Creates the new object using factory passed to the constructor and returns it Adds another object to the pool Return the object taken with method to the pool. If there are no vacant objects the new one is created using the factory passed to the constructor Add specified numbers of in counting set for . Note: If less than zero, removed method will be called Points to counting set Points to value in counting set which count will be incremented Count to add The new number of items Removes specified numbers of in counting set for Points to counting set Points to value in counting set which will be decremented Count to remove The remaining number of items Removes key from collection True if element was presented in collection, otherwise false Is presented in collection Returns count for in counting set for Gets IReadonlyCountingSet for specified key. Throws exception when key is not presented in collection Key Thrown when key is not presented in collection Tries to get IReadonlyCountingSet for specified key. Returns false when key is not presented in collection Key Value Return all keys from collection Gets IReadonlyCountingSet for specified key. If key is not presented in collection, empty set will be returned Key IReadonlyCountingSet for specified key if it is presented in collection, otherwise false Gets the number of elements contained in the collection Remove all elements from collection Lazy sorting utility: the input list would be sorted inplace during the enumeration of returned enumerator, resulting in performance benefit if you only interesting in some relatively small amount of top elements. Unsafe method for operations with bit masks. Pointer to storage Length in bits. Should be aligned to sizeof(int) bytes Sets the flag and return if flag value was actually changed. Consider using or lower directly if you don't need return Sets the flag and return if flag value was actually changed. Consider using or lower directly if you don't need return value Adapts a generic collection so that it can be handled as a non-generic collection. Type of the generic collection. Copies the elements of the to an , starting at a particular index. The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. The zero-based index in array at which copying begins. array is null. index is less than zero. array is multidimensional.-or- index is equal to or greater than the length of array.-or- The number of elements in the source is greater than the available space from index to the end of the destination array. The type of the source cannot be cast automatically to the type of the destination array. 2 Gets the number of elements contained in the . The number of elements contained in the . 2 Gets an object that can be used to synchronize access to the . An object that can be used to synchronize access to the . 2 Gets a value indicating whether access to the is synchronized (thread safe). true if access to the is synchronized (thread safe); otherwise, false. 2 Returns an enumerator that iterates through a collection. An object that can be used to iterate through the collection. 2 Dictionary with for each operation. Can be serialized/deserialized seamlessly. Reuses the single read-only instance of an empty dictionary (one per type). A list whose compares the items in their exact sequence (). A list whose compares the items in their exact sequence (). A list whose compares the items in their exact sequence (). Cached hash code of the key, -1 means entry is free Index of next entry in the chain of keys with the same hashcodes (modulo size), -1 means last Index of previous entry in the chain of keys with the same hashcodes (modulo size), -1 means first Represents the dictionary of values accessed via keys. Allows using derived/implementing types as a keys for lookup by trying to find the "best" matching registration of given some instance. There are disambiguation rules if key K matches both A and B key types, in a following order: * If type A is assignable from B, type B will be chosen as more specific; * Otherwise if there is no subtyping relationship between A and B, the type key registered first will be chosen. Example: Given {IComparable,object} map, 'IComparable' will be chosen for 'int' key (first rule) Represents collection of items that doesn't strongly hold items Gets the approximate number of elements contained in the . Adds an weak reference to item to the . The object to add to the . Removes the first occurrence of a specific object from the . true if item was successfully removed from the ; otherwise, false. This method also returns false if item is not found in the original . The object to remove from the . The is read-only. Determines whether the contains a specific value. true if item is found in the ; otherwise, false. The object to locate in the . Returns the first live element from collection The first live element from collection Returns the first live element from collection that satisfies a specified condition The first live element from collection that satisfies a specified condition Returns the last live element from collection The last live element from collection Returns the last live element from collection that satisfies a specified condition The last live element from collection that satisfies a specified condition Removes garbage from the list Static overload to prevent runtime type checks. Cached hash code of the key, -1 means entry is free Index of next entry in the chain of keys with the same hashcodes (modulo size), -1 means last Index of previous entry in the chain of keys with the same hashcodes (modulo size), -1 means first Collection similar to , but unlike in CWT: - Values are referenced via strong references, not dependent handles. - Housekeeping is performed only in lookup/remove/resize-rehash operations, meaning the values will not be reclaimed by the GC if this collection remains untouched. - If references the via strong reference, the whole entry will never be collected, resulting in memory leak. Cached hash code of the key, -1 means entry is free Index of next entry in the chain of keys with the same hashcodes (modulo size), -1 means last Index of previous entry in the chain of keys with the same hashcodes (modulo size), -1 means first Cached hash code of the key, -1 means entry is free Index of next entry in the chain of keys with the same hashcodes (modulo size), -1 means last Index of previous entry in the chain of keys with the same hashcodes (modulo size), -1 means first Mimics the MSBuild's CommandLineBuilder by its API over our so that to avoid references to MSBuild utils. Appends a separate command line parameter, quoting it if required for consistent parsing. Appends a chunk of text to the command line WITHOUT any treatment, AS IS. If you have spaces in the string, it might result in multiple arguments being parsed from the result. This is suitable for appending either trivial switch names or whole pieces of already escaped command lines (e.g. result of another builder). Turns into a command line string. Help text. Inside help string it is possible to use macros, e.g. ${AppName}
For available macros see . Help text. Inside help string it is possible to use macros, e.g. ${AppName}
For available macros see . Base class for all command line mapper's attributes. Whether option is keyed or non-keyed. If keyed then Key, Shortcut and GetKeyDefinition must not return null or throw. Key name. Key shortcut. Default: '\x0' (means no shortcut). 0-based index for non-keyed option. If set to true then all non-keyed arguments starting from NonKeyedIndex considered as multi value for this option. Whether option is required or not. IMPORTANT! If IsRequired true then option MUST BE specified and is always ignored, but still usable.
For example, [StringOption("opt", IsRequired = true, EmptyValue = "awesome")] requires opt to be specified, but it can be specified with or without value: --opt /* will have "awesome" value */ or --opt == my-value.

IMPORTANT! IsRequired has additional meaning for ImplicitGroup-s: "option required to activate implicit group".
For example, [BoolOption(..., IsRequired = true)] outside implicit group is useless (because value always will be true), but inside implicit group it means 'if this option is specified then appropriate implicit group activated'. The value which is set when no option specified at all. If option without value specified then EmptyValue is set. Default value must be the same type as option's ValueType or MultiValueType or be the String. String value will be converted via ConvertValue method. The value which is set when option without value specified. If option isn't specified at all then DefaultValue is set. If EmptyValue is null and option specified without value then error will be reported. Empty value must be the same type as option's ValueType or MultiValueType or be the String. String value will be converted via ConvertValue method. Alternative name for keyed option. Might be used in transition period when you rename some options. Symbolic value like <value> or <path>. Used in usage and help generation. Help text. Inside help string it is possible to use macros, e.g. ${AppName}
For available macros see and . Separator for multi-value. Default: '\0' which means that separator is not available. Returns definition for keyed-option. Must not be null if IsKeyed true. Default implementation returns definition with expected value, value is required if no default one provided. Formats option value to string presentation. If value is a single-value then single string is returned.

If value is a multi-value and Separator is defined for this option then single string of joined single-values is returned.
If Separator IS NOT defined then sequence of single-value strings is returned (necessary to support '--key=value1 --key=value2 ...' syntax).
 Used to mark the option or set of options as supported by particular platform only. Specifies app name which is used in help/example/command line generation. Specifies app name for options model class. app name without extension type of the option filter attribute, must be the type derived from The key defining explicit group. Must be the same as specified in appropriate [ExplicitGroup] attribute. The value of defining this explicit group. The following types are supported: string, int, enum. Whether group default or not? The default group is mapped when defining key-value is omitted in command line.

IMPORTANT! If appropriate [ExplicitGroup] attribute specified with IsRequired = true then default mapping is ignored. Used to specify platform dependent default value. Used to specify platform dependent empty value. Defines option order number. Options are stable sorted ascendingly by this number. If no attribute specified then 0 order number supposed.
Affects options order inside single class only but including all base classes.

By default options defined in base class will precede options from derived one. Using OptionOrderAttribute it's possible to override this order. Used to specify platform dependent default value. Represents parsed command line argument either keyed with optional value or non-keyed. Represents command line parsing/mapping error which should be shown to end-user. Represents group signature which is set of required options. Builds command line from typed options model. Maps CommandLineArgument-s to typed options model. Features:
* supports types: string, int, bool, enum, TimeSpan, FileSystemPath
* extensible: easy to map custom types
* supports collection assignable from T[]
* supports multi-value specified via separator or repeating key (e.g. '--list=a,b,c' or '--list=a --list=b --list=c')
* supports commands (a-la 'git push')
* supports implicit group deduced on the set of provided arguments
* supports mutually exclusive groups and multi-groups
* provides auto-help generation
* supports sample generation from options model
* supports raw command line tail: useful for passing arguments to started child-process
 See CommandLineMapperExamples in test-project. Current help generator. Returns KeyDefinition-s built by options model. Key definitions are used by parser to support feature 'space as value separator'.
E.g. -f <file-name>
If -f option expects a value then <file-name> is a value for keyed option 'f' otherwise <file-name> is a non-keyed option. Maps CommandLineArgument-s to typed options model with auto-processing of help keys and/or command. If command line doesn't contain any argument then also help is displayed. Returns null if help was displayed. Maps CommandLineArgument-s to typed options model. Returns null if and only if command line doesn't contain any argument. Parses command line, resolves shortcut and alias to key name and provides sequence of CommandLineArgument-s. Parses command line according to provided key definitions and returns sequence of CommandLineArgument-s. Provides method to format sample options as command line. Formats a command line according to passed options. Generates help by options object model. Generates generic help for options model. Generic help includes only command names with description but without detailed options. Generates help for specific command/group. Basic implementation which able to parse the following cases:
<non-keyed-value>
<key-marker><key>
<key-marker><key>:<value>
<key-marker><key>=<value>
<key-marker><key> <value> // if 'space-as-value-separator' feature enabled
<shortcut-marker><shortcut>[<shortcut>...]
<shortcut-marker><shortcut>[<shortcut>...]:<value>
<shortcut-marker><shortcut>[<shortcut>...]=<value>
<shortcut-marker><shortcut>[<shortcut>...] <value> // if 'space-as-value-separator' feature enabled
<shortcut-marker><shortcut>[<shortcut>...]<value>
where <shortcut> is a single char

Also supports <non-keyed-mark> after wich all following arguments are treated as non-keyed.
See: https://en.wikipedia.org/wiki/Command-line_interface#Option_conventions_in_Unix-like_systems We have to sort all KeyMarks by their length so that if both '--' and '-' are present in KeyMarks and the command line fragment is '--foo' the TrimShortcutMark will return 'foo' rather than '-foo' if in KeyMarks the '-' mark is specified before '--' mark Treats - (single dash) as key marker but not a shortcut. Under Windows / (slash) also treated as key marker.

<key-marker> ::= -- | / | -
<shortcut-marker> ::= (none)
<non-keyed-mark> ::= --

Examples: --name=value --name:value /name=value /name:value -name=value -name:value -- -non-keyed --non-keyed If enabled then keys which haven't definition will be converted to CommandLineArgument with given name and without alias/shortcut resolving. If enabled then non-keyed value followed key expecting value will be parsed as value of this key. Sets callback when keyed-option found by its original name. Might be used to display deprecation warning. void OnKeyFound(string prefix, string key) Sets callback when TreatUndefinedKeyAsIs enabled and undefined keyed-option found. Might be used to display deprecation warning. void OnUndefinedKeyFound(string prefix, string key) Sets callback when keyed-option found by its shortcut. Might be used to display deprecation warning. void OnShortcutFound(string prefix, char shortcut, string key) Sets callback when TreatUndefinedKeyAsIs enabled and undefined shortcut found. Might be used to display deprecation warning. void OnUndefinedShortcutFound(string prefix, char shortcut) Sets callback when keyed-option found by its alias. Might be used to display deprecation warning. void OnAliasFound(string prefix, string alias, string key) Called when keyed-option found by its original name.
void OnKeyFound(string prefix, string key) Called when TreatUndefinedKeyAsIs = true and undefined keyed-option found.
void OnUndefinedKeyFound(string prefix, string key) Called when keyed-option found by its shortcut.
void OnShortcutFound(string prefix, char shortcut, string key) Called when TreatUndefinedKeyAsIs = true and undefined shortcut found.
void OnUndefinedShortcutFound(string prefix, char shortcut) Called when keyed-option found by its alias.
void OnAliasFound(string prefix, string alias, string key) Generates help expanding groups inplace. Might be useful for tools with simple command line. TODO: provide example here Default implementation of help generator. ] [--save-to=] [--log-level[=ERROR|WARN|INFO]] logging level [--log-file=] log file path [--save-to=] folder path to save workspace to help Display help related to specified command. get-snapshot Get snapshot of running .NET process. start Start standalone application under profiling and get snapshot by triggers. ]]> [--as-admin] ::= | ::= --pid|-i= Specify process by PID. --pid|-i= process identifier ::= --name|-n= [--with-max-mem] [--all] Specify process by name with some optional conditions. --name|-n= process name with optional extension [--with-max-mem] snapshot a process with max memory consumption [--all] snapshot all processes with specified name [--as-admin] elevate to admin privileges E.g: dotMem get-snapshot --pid=2025 Get snapshot of process with PID 2025. E.g: dotMem get-snapshot --name=PaintDotNet --all Get snapshot of all processes with name PaintDotNet. E.g: dotMem get-snapshot --name=PaintDotNet --with-max-mem Get snapshot of process with name PaintDotNet, if several instances are running pick one which consumes max memory. ]]> The following macros defined for current option:
${Key} - without key marker; only defined if option keyed
${Shortcut} - without shortcut marker; only defined if option has shortcut
${Alias} - without marker; only defined if option has alias
${DefaultValue} - ; only defined if default value was specified
${EmptyValue} - ; only defined if default value was specified
${FormattedKey} - key and shortcut with appropriate markers, something like `--key|-k` ${sep} - ; only defined if separator was specified ${AppName} - application name
${AppNameDotExe} - application name with `.exe` suffix
${EnvTempDir} - temp path environment variable (%Temp% or $TMPDIR) depending on running platform
${ExitCode.Failure} - value of
${ExitCode.Success} - value of
${--} - key marker (`--` or `/`)
${-} - shortcut marker (`-`)
${=} - value separator (`=` or `:`)
${/} - path separator (`/` or `\`) depending on running platform
${Help} - name of help command or formatted help key
 Default implementation of IExampleFormatter Key marker. Shortcut marker. '\x0' if not supported. Marker which means 'all followed arguments are non-keyed'. Usually -- (double dash). Name-value separator. Treats -- (double dash) and / (slash) on Windows as key markes, - (single dash) as shortcut marker.

<key-marker> ::= -- | /
<shortcut-marker> ::= -
<non-keyed-mark> ::= --

Examples: --name=value --name:value /name=value /name:value -n=value -abc -- -non-keyed --non-keyed <key-marker> ::= --
<shortcut-marker> ::= -
<non-keyed-mark> ::= --

Examples: --name=value --name:value --name value -n=value -n:value -n value -nvalue -abcn=value -- -non-keyed --non-keyed Provides set of methods which format option declared in object model in some specific style. E.g. --option or /option or -o etc. Used to generate help, usage hints, usage samples and to format error messages which contain reference to some option. Key marker. Shortcut marker. '\x0' if not supported. Marker which means 'all followed arguments are non-keyed'. Usually -- (double dash). Name-value separator. Formats option like this: '--option|-o[=<value>[,<value>,...]]'. Used to generate help or usage hints. Formats group like this: '<group> [<group>...]'. Used to generate help or usage hints. Formats group definition like this: 'command' or this '--group=group-def'. Used to generate help or usage hints. Formats option with specified value(s) like this: '--option=value' or '--option=value1 --option=value2'. Used to generate usage samples. Formats option name like this: '--option|-o'. Used to generate help or usage hints. Formats group name like this: '<group>'. Used to generate help or usage hints. Returns command line tail (in raw form) starting from given non-keyed parameter. Raw means 'as was provided by caller'. Command line raw tail used when we need to bypass part of original command line to sub-process as-is. Mix-in interface for option which able to return raw value (raw means no additional quoting required). A special stub class to assign to field marked as [FileSetOption] in order to build command line from model. Members of IReadOnlyList not supported by this stub and throws an exception. The non-Roaming Application Data, shared for all company data. Usually it's Environment.SpecialFolder.LocalApplicationData / CompanyInfo.Name, but can be overridden by the value of the environment variable . This environment variable won't be inherited by child processes after first calculation of this property The Roaming Application Data, shared for all company data. Usually it's Environment.SpecialFolder.RoamingApplicationData / CompanyInfo.Name but can be overridden by the value of the environment variable . This environment variable won't be inherited by child processes after first calculation of this property Temp folder, shared for all company data. Usually it's TEMP / CompanyInfo.Name but can be overridden by the value of the environment variable . This environment variable won't be inherited by child processes after first calculation of this property Using internal resources for running tests, requires authorization. Using external resources for running tests, no authorization required. An EnumPattern implementation which supports conversion from a text string. The internal dictionary is typically populated lazily by static constructors of classes, which may be located in different assemblies. That means that it is not guaranteed that at any moment of time the internal dictionary are aware of all possible patterns. When you ask for named EnumPattern you can be the first one, who even asked for such pattern and you have to provide a way to construct the pattern object itself by providing a factory method. For example, in serialization scenarios the deserialization may be happened before static constructor invocation of a different class in the other assembly. For this reason, it is advised against using the FromString method. A TypeConverter implementation for the ConvertableEnumPattern type. Methods CanConvertTo and ConvertTo are not implemented, cause the base implementations do all we need. Validates collections by preventing certain values from being added or removed. Note that for the validator to attach, the original values must all pass the validation. Makes a readonly list. All the legitimate modifiers must pass the as an argument. If the is invalid, an exception is thrown. Ensures the is modified only on the thread this function was called on. Ensures the is modified only on the thread this function was called on. A stream which allows to access memory outside the process' virtual address space. That would be RAM if enough is available, or it might be paged out to disk. The default exponent (base is 2) for the bank size. 1MB in 32bit, 16MB in 64bit. The default number of banks which can be mapped into process memory at the same time. The exponent (base is 2) for the bank size. Must be protected with . List of immutable substreams currently opened within the body of the main stream, which have a fixed length and cannot be grown. Stores those which do not have a lifetime but are garbage collected, so held by weak reference and removed by collection logic when the reference invalidates. Must be protected with . At most one substream currently writing at the end of the main stream; this one has a growing length. Must be protected with . List of substreams currently opened within the body of the main stream, which have a fixed length and cannot be grown. Stores those which have a limiting lifeitme, removed upon termination. Must be protected with . The fixed-length data part. To get the full written length, append the length of , if any. Must be protected with . The lifetime for unmanaged resources behind the stream. The maximum length of the stream. This memory is not initially committed. Must be a multiple of the bank size. Bank fine tuning. The lifetime for unmanaged resources behind the stream. An externally-created MMF, to attach to, or NULL to create a new one. The maximum length of the stream (this memory is not initially committed), if no external MMF is specified. Otherwise it's assumed to be the size of the pre-allocated MMF. Must be a multiple of the bank size. This number of bytes at the beginning of the is considered as already written. Stream returns this value. Bank fine tuning. As only one appender substream can be opened at any given time, tells whether the option is available. Length of the fixed-length part of the stream. If there is an append-mode stream open, does not include it. Gets the maximum this object is allowed to reach. Full length of the stream, including the parts being written at the moment. Extends a body of this stream by the given length, and opens the new bytes as a fixed-length substream. The variable-length writre must not be opened. Writable and readonly streams must not intersect. Attaches to an existing memory-mapped file. Stream lifetime, and lifetime of all the MMF views it opens. The MMF itself isn't destroyed when the lifetime ends. An already-open MMF of size . Total size of the . Must be a multiple of the bank size. This number of bytes at the beginning of the is considered as already written. Stream returns this value. Bank fine tuning. Allocates an MMF the standard way, just as this object would do by default. Opens a view on the whole stream which can change the length freely to grow or shring. There might be at most one such view. No other substreams are allowed: no tail-growing substreams (because this one is essentialyl tail-growing as well); no immutable substreams (obviously); no fixed-length substreams (because this stream might shring past them, and when created, it resets committed length to zero, so no other streams might exist). Opens an immutable stream without a lifetime. Effectively, the lifetime of the class still limits the usable lifetime of the stream, so you have to make sure all active uses fall within. Other than that, the stream is “closed” as soon as it's garbage collected. Stream instances are not reused because they have to have independent positioning, but they reuse some of the data to make sure digest is not calculated anew for each clone. Opens an immutable stream which looks on a view within the body of this stream. The stream is considered closed when its lifetime ends. Each call opens a new stream with its own lifetime. Opens a stream which looks on a view within the body of this stream. Cannot change its length. Writable and readonly streams must not intersect. Opens an initially empty stream which writes to the end of this stream. Can grow both its length and the parent stream length. Can't have more than one such. Always RW. Reads a sequence of bytes from the current memory stream holder without allocating a substream — same as opening a fixed-length readonly substream for the range and reading, but skips the checks and creation. Cannot read from within the current appending stream, only part is available. If is active, then no memory is available for reads here. The stream offset to start reading at. Points to the first byte of the destination buffer. The number of bytes to copy. There's no WriteAt because it'd still have to do all the slow checks on if there're any conflicting immutable streams, so create a substream for that. You can call this if you're not going to be using this object for some time. They'll be reopened automatically. Incremented (thread-safely) for the time smb is using the bank for operations. Prevents releasing the bank view. Zero means the bank is not in use, available for use, and can be freed. A very negavtive value (like, MinValue) is set atomically before releasing the bank, to make sure noone locks it for use. Upon creation, the bank gets a valid view and a ref count of 1, assuming the bank is initially in use and shan't be freed, don't forget to decrease. Releases and NULLs the view, unless in use. True if released now. A released bank always returns True. Defines how many banks and of which size this stream should use for accessing the memory. Optional. Allows to change the exponent (base 2) of the bank size. Zero means use default . Optional. Max number of banks which can be mapped into process memory at the same time. Zero means use default . Caches a few open banks, closes the oldest ones, opens new ones. Must be fully thread-safe. A copy of , but ordered for removal of oldest. Caches a few open banks. The idea is that the structured storage file system managing code would be writing the content and the filesystem tables intermittently, so the file tables' banks better be left open. The exponent (base is 2) for the bank size. Protects all free-threaded operations on this object. The number of banks which can be mapped into process memory at the same time. Might be violated if all of the opened banks are locked for use and we need even more. Gets the cached or openes a new bank whose view starts at the given offset (must be a multiple of the bank size). You can call this if you're not going to be using this object for some time. They'll be reopened automatically. has been called. For a tree of clones, tracks the original root instance. Main use with GC-tarcked streams, any clones keep the original pinned. End of the current stream view, in MMF-relative coordinates. Global length limit in MMF-relative coordinates. The current position of this stream, in MMF-relative coordinates. Start of the current stream view, in MMF-relative coordinates. has been called, here or on parent. This stream can't grow by writing. An effective stream on subrange, in that it does not add an extra layer of calls. Writes a sequence of bytes to the current stream at the specified position without touching the stream value. The stream might however increase. The stream offset to start writing at. The is not considered or modified by this call. Points to the first byte of the source buffer. The number of bytes to copy. We don't return the number of written bytes because reading less than requested is a failure HR and will be thrown out as an exception. Reads a sequence of bytes from the current stream at the specified position without touching the stream value. The stream offset to start reading at. The is not considered or modified by this call. Points to the first byte of the destination buffer. The number of bytes to copy. Mapping from one family of objects into another and vice versa. Uses the Compact Map inside. This consumes less memory and won't hit the LOH, but is a few times slower. So in perf-critical scenarios without big mem pressure choose the . Get the number of mappings. As we implement the identity mapping, the number of items on both sides is always in sync. Adds a new mapping to the map. Both ends must be unique in their maps. Adds a new mapping to the map. You should use whenever possible, as it throws on dpulicate keys. Left key. Right key. Whether to ignore duplicate keys in left and right collections silently. Not recommended. The conflicting mappings will be dropped. Turns a value type into a reference type — similarly to , but the resulting type is a reference type not a value type. Turns a value type into a reference type — similarly to , but the resulting type is a reference type not a value type. Supports , mostly taken from . Effective replace of for sparse and almost filled set. Effective for density of 1-s between 0 and 0.1, and beween 0.9 and 1. Inspired by http://ricerca.mat.uniroma3.it/users/colanton/docs/concise.pdf Non thread-safe Slow implementation, no memoization Utility for fibbonacci number Find minimal fib number larger or equal to give lowest fibbonaci number greater or equal to given Searches index idx in array such as idx - lowest possible number that satisfies [idx] >= x. Input value Index in Hash set for ints. Internally contains a single array so memory usage is low (but loadfactor is 0.75 to provide high speed for Add, Contains and Remove operations). The set is initialized with so-called marker element (0 by default) which is always contained in this set (you can't remove it). So set minimum size () is 1. Not equal to any number obtained by Compares strings by their natural sorting order, which is, case-insensitively and treating digits and numbers, where 2 goes before 10. 26 bits for size means we one key can hold from 0 to 67,108,864 values exclusively. Capacity for a given key is a log2 for #fibbonacci_number (0 is reserved for exact fit capacity). So maximum capacity is fib(64) which is far larger than maximum count (as per ). Analogous to but correctly handles with index greater than the current capacity. Also includes some additional facilities like which is used in enclosing map's compaction procedure. Struct enumerator to reduce memory traffic Not equal to any number obtained by True if further search is not needed Compacts and returns number of compacted entries. Compacts if CompactionPolicy is met. Number of compacted entries or -1 if CompactionPolicy is not met Gets or sets the element with the specified key. The element with the specified key. The key of the element to get or set. is null. The property is retrieved and is not found. Unmanaged piece of memory that MUST be taken by using (var mem = SafeUnmanagedMemory.Alloc(sizeInBytes) {...} construct. Works faster then because doesn't use utility inside. A trie which stores hierarchically nodes whose keys are lists of . Synthetic root. Sets a value to the trie, possibly updating an existing value. An enumerator which produces the keys for the path in the trie. The value to be set. A NULL value would be set as any value, the node would not be deleted. User-defined context for the enumerator function. Removes all nodes on any possible prefixes of . Sets a value to the trie. An enumerator which produces the keys for the path in the trie. The value to be set. A NULL value would be set as any value, the node would not be deleted. User-defined context for the enumerator function. Gets a value from the trie if it is defined. An enumerator which produces the keys for the path in the trie. The value, if set; NULL otherwise. User-defined context for the enumerator function. Whether the value were set and is returned in . Adds a new value or updates an existing one. If True, has the existing value you would be updating. If False, the node had no existing value, is NULL, and you should return the new value. The existing value of the node, if there were such (and is True). NULL otherwise. The user-defined context. The value to set to the node. A non-allocating compound key producer function, as an alternative to passing the of keys as the compound key. Defines the path in the trie. To produce the keys in the path, an algorithm will call repeatedly. The static context. This is passed thru as is from algorithm user to the algorithm and by the algorithm to the key enumerator function. Not supposed to change with iteration, though it's up to key enumerator implemenation. Example: the string on which to enumerate parts. The state of the enumerator. Passed by reference. On the first call, would be NULL. On each call the key enumerator implementation is expected to change this state so that on the next call it returned the next part. The next key, if return value is True. Undefined otherwise. Whether this iteration produced a valid item. True means is the next valid key. False means the iteration has gone out of bounds and is over, is an undefined value, iteration should now stop. The iteration is not guaranteed to be completed by the caller (might abort after few first items). There is no “enumeration dispose” call. Represents string that consists of other strings. The way of avoiding string concatenation and high memory traffic. Works fast for small number of parts. Typical replace for: namespace + "." + typeName Represents string that consists of other strings. The way of avoiding string concatenation and high memory traffic. Works fast for small number of parts. Typical replace for: namespace + "." + typeName Sometimes we have to trick some feature into thinking that it works on its own stream, while actually it gets only a substream from some other larger stream (or file). An example would be features like ZIP which would seek into beginning and the end. Another case is appending to a larger stream, while some features would like to rewind first. And it also won't dispose the underlying stream on close. The underlying stream. Won't be disposed of! Start of the view. Length of the view. A nonnegative number means a fixed length, and NULL means “to the current end of the underlying stream”, and it allows growing the stream on write. Allows to limit operations on the underlying stream. Creates a substream for appending to the end of another stream. Writable, growable, asserts at end. Represents an integer value with specific semantics that cannot be freely assigned to/from other ints. This type is not used for storing data values. It it solely used for distinguishing between typed intrinsics. Limits the current value. Returns a copy that's guaranteed to be in the [, ) limits. Subtracts one from the current value. Does not modify the original object. Adds one to the current value. Does not modify the original object. Truncates the value to be at most the given maximum. Does not modify the original object. Truncates the value to be at least the given minimum. Does not modify the original object. Indicates whether this instance and a specified object are equal. true if and this instance are the same type and represent the same value; otherwise, false. Another object to compare to. 2 Returns the hash code for this instance. A 32-bit signed integer that is the hash code for this instance. 2 Compares the current instance with another object of the same type. A 32-bit signed integer that indicates the relative order of the objects being compared. The return value has these meanings: Value Meaning Less than zero This instance is less than . Zero This instance is equal to . Greater than zero This instance is greater than . An object to compare with this instance. is not the same type as this instance. 2 Compares the current object with another object of the same type. A 32-bit signed integer that indicates the relative order of the objects being compared. The return value has the following meanings: Value Meaning Less than zero This object is less than the parameter.Zero This object is equal to . Greater than zero This object is greater than . An object to compare with this object. Returns the for this instance. The enumerated constant that is the of the class or value type that implements this interface. 2 Converts the value of this instance to an equivalent Boolean value using the specified culture-specific formatting information. A Boolean value equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent 8-bit unsigned integer using the specified culture-specific formatting information. An 8-bit unsigned integer equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent Unicode character using the specified culture-specific formatting information. A Unicode character equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent using the specified culture-specific formatting information. A instance equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent number using the specified culture-specific formatting information. A number equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent double-precision floating-point number using the specified culture-specific formatting information. A double-precision floating-point number equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent 16-bit signed integer using the specified culture-specific formatting information. An 16-bit signed integer equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent 32-bit signed integer using the specified culture-specific formatting information. An 32-bit signed integer equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent 64-bit signed integer using the specified culture-specific formatting information. An 64-bit signed integer equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent 8-bit signed integer using the specified culture-specific formatting information. An 8-bit signed integer equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent single-precision floating-point number using the specified culture-specific formatting information. A single-precision floating-point number equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent using the specified culture-specific formatting information. A instance equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an of the specified that has an equivalent value, using the specified culture-specific formatting information. An instance of type whose value is equivalent to the value of this instance. The to which the value of this instance is converted. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent 16-bit unsigned integer using the specified culture-specific formatting information. An 16-bit unsigned integer equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent 32-bit unsigned integer using the specified culture-specific formatting information. An 32-bit unsigned integer equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Converts the value of this instance to an equivalent 64-bit unsigned integer using the specified culture-specific formatting information. An 64-bit unsigned integer equivalent to the value of this instance. An interface implementation that supplies culture-specific formatting information. 2 Indicates whether the current object is equal to another object of the same type. true if the current object is equal to the parameter; otherwise, false. An object to compare with this object. Formats the value of the current instance using the specified format. A containing the value of the current instance in the specified format. The specifying the format to use.-or- null to use the default format defined for the type of the implementation. The to use to format the value.-or- null to obtain the numeric format information from the current locale setting of the operating system. 2 Wraps a instance and does not the consumer of this class to close that instance. Mapping from one family of objects into another and vice versa. Get the number of mappings. As we implement the identity mapping, the number of items on both sides is always in sync. Adds a new mapping to the map. Both ends must be unique in their maps. Adds a new mapping to the map. You should use whenever possible, as it throws on dpulicate keys. Left key. Right key. Whether to ignore duplicate keys in left and right collections silently. Not recommended. The conflicting mappings will be dropped. Reimplementation of Dictionary. Cached hash code of the key, -1 means entry is free Index of next entry in the chain of keys with the same hashcodes (modulo size), -1 means last Static overload to prevent runtime type checks. Static overload to prevent runtime type checks. Static overload to prevent runtime type checks. Static overload to prevent runtime type checks. Cached hash code of the key, -1 means entry is free Index of next entry in the chain of keys with the same hashcodes (modulo size), -1 means last Presents uint[] (this) packed into uint[][] (myChunks). Each chunk is UncheckedPackedIntArray which supplies compression. Chunks are used to avoid LOH. To take i-th element of 'this', invoke GetItem(i, valueBits, 0). You can also use this[ith] to get/set values with array of one element (in case of valueBits less than '32'. One can increase or reduce size of elem by invocation of IncreaseValueBits(ChunkPackedIntArray oldArray, int newValueBits) Returns the first element of array Create chunk array with pre-allocated given size Collection which optimized to store single item without allocating array. The collection cannot contain null elements! IT'S NOT A STRUCTURAL EQUALITY! Only here to get rid of default struct equality Adds an item into the collection if it does not exist Item to add true if item added, false if it existed previously This collection after moving from dotCommon lost calculation of the chunk size and became a STRUCT. It is used only in and which do not have any tests. Please do not make it public and do not use it in the any new code, use normal instead. Creates array that can exceed 2Gb per object limit of .NET The length of the array The length of the one chunk. Must be pow of 2 Creates array with guarantee that data will not be allocated in LOH The count of array elements Returns false if the expected key does not exist in the registry or exceprion is thrown Presents uint[] (this) packed into another uint[] (myData). valueBits parameter for each method denotes size in bits of one element of 'this' Can be much or less than '32' bits, which is the size of myData element. No range checks are performed. To take i-th element of 'this', invoke GetItem(i, valueBits, 0). You can also use this[ith] to get/set values with array of one element (in case of valueBits less than '32'. One can increase or reduce size of elem by invocation of IncreaseValueBits(UncheckedPackedIntArray oldArray, int length, int oldValueBits, int newValueBits) Calculates this[iSubItem] A delegate for a -like method. Subtracts the from the , the difference is written into the , inplace, so that the original list is destoryed. The difference, in the instance. return interator from internal storage. Trie cannot be modified while enumerating Returns snapshot of the stored items. Shared API to the . Instructs the debugger to attach to the process with the PID . Instructs the debugger to attach to the process with the PID on machine . Instructs the debugger to detach from all the debuggee processes. Instructs the remote (or local) in the process to attach to the process. Instructs the remote (or local) in the process to attach to the process. Instructs the remote (or local) in the process to detach from all the debuggee processes. Gets the API to the debugger host running in the given process as a late-bound . Shares some Devenv discovery code which is also required in non-devenv-specific code, like installers and assembly resolvers. Gets the version-independent Registry Visuyal Studio path prefix. Currently, "Software\Microsoft\VisualStudio". The subfolders under VS InstallDir which might contain those DLLs previously in the GAC which are now side-by-side shipped within VS 15+ without a global registration. This skips VS6 which is still found in the wild(!) [RSRP-462081] and would be useless on our discovered VSes list. This skips VS13 which has never been released and 14 goes after 12 This skips classic VS15 that's obsolete. This skips VS15 when VS discovering is called inside the process with loaded registry detour hive. Enumerates Visual Studio versions found installed on this machine. This should include side-by-side installations of the new VSes. Enumerates Visual Studio versions found installed on this machine. This should include side-by-side installations of the new VSes. Knowing that VS environment is based on msenv.dll, gets the path of the loaded module. Gets the Visual Studio registry path prefix for a specific Registry hive. Example: “Software\Microsoft\VisualStudio\8.0ReSharper”. Gets the Visual Studio registry path prefix for a specific registry config hive. Example: “Software\Microsoft\VisualStudio\14.0ReSharper_Config”. Gets the path to the Visual Studio local/roaming/common appdata folder for the given VS Hive. Gets the root path to the Visual Studio local/roaming/common appdata folder. Retrieves the Devenv InstallDir for the specific hive. Reads the Registry Hive at the supplied Registry path to read the InstallDir. Return the path to the "privateregistry.bin" file. If the VS does not use regsitry detouring, returns an empty path. If the file exists, returns the file. If the file does not exist, tries to guess its name. As recommended by MSFT, tries to get the full 4-component VS version from fileversion of msenv.dll. Determine whether we are able to discover VS15+ instances. S_OK discovery available; S_FALSE VS15+ not installed; E_ACCESSDENIED elevation probably required; or another error code. Enumerates Visual Studio versions installed on this machine. This should include side-by-side installations of the new VSes. VS 15 lt Preview 3 on 2016-07-07. Fills the list for those VS versions which expose this information. Get VS15+ extended info: preview, nickname Include non-VS instances (e.g. Microsoft.VisualStudio.Product.BuildTools, Microsoft.VisualStudio.Product.TestProfessional). The full 4-component VS version, which does not correspond to the hive name anymore even in the first components (e.g. 15.7.x.y is hive 15.0), for the hive version look into . The long display name for descriptions and tooltips. The short display name for list items. The VS Hive, which consists of a two-component version and optional instance id and root suffix. This is enough for identifying the VS instance in most of the cases. InstallDir of VS, which is the directory with devenv.exe, $(InstallRoot)/Common7/IDE. Gets the list of VS packages. NULL if not known. Empty if known to be empty. This info is only available for VS 15 RC and later, and if the were specified. VS installation is incomplete. Applicable to VS 2017+ only. channelId contains "Preview" substring (examples of channels: "VisualStudio.15.Preview", "VisualStudio.15.Release") VS15+ instance nickname given by the user at the installation. The path to the installation root of the product. VS15+ display version. E.g. Version4="15.7.27703.2000" is "15.7.1". VS15+ state of the VS instance. General package identifier. Package version. Have not bothered to parse the format yet. Package type, see for reference. Unique package identifier (consisting of all defined tokens). Should be the only Product component, identifies the installation itself. Workloads are big buttons in the installer to select the roles. Calls into the VS Setup Configuration COM Object, if present on this machine. This should serve VS instances starting with VS15 RC. Brought into a separate class to help with containing possible JIT-time exceptions. Get the map of VS process ids to DTE objects. Try to find the "best" VS DTE object and execute the command with it. Try to execute a VS command using DTE object. _DTE object. We cannot reference envdte.dll here, so we use dynamic. VS command name. Command arguments. True if there was no exception. It does not mean that the command is executed, because it could be not available at the moment. Gets the Registry key path to the given subkey in the current VS Registry Hive. Gets the path to the Visual Studio local/roaming/common appdata folder for the given VS Hive. Provides info on the VS environment. InstallDir of the current VS version. Gets the VS Hive that consists of the VS Version, VS RootSuffix and (since VS15) VS Instance Id. Gets the version of the Visual Studio we're running under, two components only, Major.Minor. Example: “8.0”. Gets the version of the Visual Studio we're running under, the full 4-component thing. Example: “9.0.30729.1”. The long display name for descriptions and tooltips. The long display version for descriptions and tooltips, e.g. "16.11.0 Preview 1.0". This is an instance of "Visual Studio Preview" (since VS15). Gets the Visual Studio registry path prefix for a specific Registry hive. Example: “Software\Microsoft\VisualStudio\8.0Receptor”. Note: this path is not redirected to the local hive of the current Visual Studio running instance. Main implementation of is VsEnvironmentInformation which relies on information from a live Visual Studio instance to function. If you'd like to emulate this behavior outside Visual Studio (e.g. to get vs-version-specific product settings location), create an instance of this object on explicitly-supplied parameters. Supplies manual info about VS environment. A hive, e.g. in Visual Studio, is a two-component version number, plus an optional string for the root suffix. Starting VS15 it also contains the instance id. Visual Studio technical version. NOTE that its minor component is almost always zero (the only known exception is v7.1), even though the marketing version might have nonzero minors which do not take part in any folder or Registry composition. For example, for VS17 its technical version is always v17.0, while they've been marketed as 17.1, 17.2, …, 17.12 and still counting. Gets the canonical textual representation of the hive. Example: "15.0_a0848a47Exp", where VS version = "15.0", Instance Id = "a0848a47", Root Suffix = "Exp". Create a new hive with another root suffix. Parse the VS hive string, throw an exception if failed. Try to parse the VS hive string. We assume that hive string is {Version}[_{InstanceId}]{RootSuffix}. If hive is parsed successfully, pair.First is the VS hive. Otherwise pair.First is null, and pair.Second is the error message. Used for backward compatibility. HostInfo and Installer store hive strings withot VS version number. Identity of an event. Defines a call tree node name. Can be customized by Optional arg for customizing Identity of an event. Defines a call tree node name. Can be customized by and Optional arg for customizing Optional arg for customizing Writes a "begin event" to the ETW. All callstacks between "begin event" and next "end event" on one thread will be attached to their common ancestor. Identity of an event. Defines a call tree node name. Description, additional info for filters and Events view. Optional color. Will be displayed in filters. 0xAARRGGBB Writes an "end event" to the ETW. Duplicated end events are ignored by the dotTrace Single frame after diffing two entities Single frame after diffing two entities Type of the single diff frame Nant-syntax wildcard matcher on file system trees Represents an IPv6 IP Address This struct is used by various classes in the namespace to represent IPv6 addresses. IP fragment 1 IP fragment 1 IP fragment 2 IP fragment 2 IP fragment 3 IP fragment 3 IP fragment 4 IP fragment 4 IP fragment 5 IP fragment 5 IP fragment 6 IP fragment 6 IP fragment 7 IP fragment 7 IP fragment 8 IP fragment 8 returns a string representation of the IP address v6 a human readable ipv6 address Used to display a human readable IPv6 address. Represents an array of IP addresses This struct is used by the DnsQuery API to hold the selected DNS servers to query. Gets or sets the number of element in the array. Gets or sets the array of IP addresses Represents a complete DNS record (DNS_RECORD) This structure is used to hold a complete DNS record as returned from the DnsQuery API. Gets or sets the next record. Gets or sets the name of the record. Gets or sets the type. Gets or sets the data length. Represents the flags of a . Reserved. Reserved. Gets or sets the flags. Gets or sets the TTL count Reserved. DNS query types This enum is used by the DnsQuery API call to describe the options to be given to a DNS server along with a query. Standard Accept truncated response Use TCP only No recursion Bypass cache Cache only Directs DNS to ignore the local name. Prevents the DNS query from consulting the HOSTS file. Prevents the DNS query from using NetBT for resolution. Directs DNS to perform a query using the network only, bypassing local information. Treat as FQDN Allow empty auth response Don't reset TTL values Reserved. obsolete. Directs DNS to return the entire DNS response message. The possible return codes of the DNS API call. This enum can be used to decypher the property's return value. This enum is used to describe a failed return code by the DnsQuery API used in the class. Successful query Base DNS error code Base DNS error code DNS server unable to interpret format. DNS server failure. DNS name does not exist. DNS request not supported by name server. DNS operation refused. DNS name that ought not exist, does exist. DNS RR set that ought not exist, does exist. DNS RR set that ought to exist, does not exist. DNS server not authoritative for zone. DNS name in update or prereq is not in zone. DNS signature failed to verify. DNS bad key. DNS signature validity expired. Packet format No records found for given DNS query. Bad DNS packet. No DNS packet. DNS error, check rcode. Unsecured DNS packet. Possible arguments for the DnsRecordListFree api This enum is used by the DnsRecordListFree API. Reserved. Frees the record list returned by the DnsQuery API Represents the exception that occurs when a fails. The exception that occurs when a DNS request fails at any level. This class is used to represent two broad types of exceptions: Win32 API Exceptions that occurred when calling the DnsQuery API Exceptions of other types that occurred when working with the and classes. Win32 errors that are DNS specific are specified in the enumeration but if the returned is not defined in that enum then the number returned will be defined in WinError.h. Exceptions of other types are available through the InnerException property. Initializes a new instance of Used to raise a with all the default properties. The message property will return: Unspecified DNS exception. Initializes a new instance of the human readable description of the problem Used to raise a where the only important information is a description about the error. The property will return 0 or SUCCESS indicating that the DNS API calls succeeded, regardless of whether they did or did not. Initializes a new instance of the human readable description of the problem the error code () if the DnsQuery api failed Used to raise a where the underlying DNS API call fails. In this case, the property is the most important information about the exception. In most cases, the number returned is a value in the enum however, if it is not, the error is defined in WinError.h. Gets the error code () if the DnsQuery api failed. Will be set to success (0) if the API didn't fail but another part of the code did. Win32 errors that are DNS specific are specified in the enumeration but if the returned is not defined in that enum then the number returned will be defined in WinError.h. Value will be defined in WinError.h if not defined in the enum. This example shows how to decypher the return of the ErrorCode property. try { ... } catch(DnsException dnsEx) { int errcode = dnsEx.ErrorCode; if (! Enum.IsDefined(typeof(DnsQueryReturnCode), errcode)) { //defined in winerror.h Console.WriteLine("WIN32 Error: {0}", errcode); return; } DnsQueryReturnCode errretcode = (DnsQueryReturnCode) errcode; if (errretcode == DnsQueryReturnCode.SUCCESS) { //inner exception contains the goodies Console.WriteLine(dnsEx.InnerException.ToString()); return; } //dns error Console.WriteLine("DNS Error: {0}", errretcode.ToString("g")); } Initializes a new instance of the human readable description of the problem the exception that caused the underlying error Used to raise a where the exception is some other type but a typeof(DnsException) is desired to be raised instead. In this case, the property always returns 0 or SUCCESS and is a useless property. Initializes a new instance of for the serialization information the context Used by the interface. DNS record types This enum represents all possible DNS record types that could be returned by the DnsQuery API. Address record Name Server record Obsolete Obsolete Canonical Name record Start Of Authority record Mailbox record Reserved. Reserved. NULL data for a DNS resource record. Well-Known Service record Pointer record Host Information record mail information (MINFO) record Mail Exchange record Text record Responsible Person record AFS Data Base location record X25 ISDN Route Through Network service access point address record Obsolete Cryptographic signature record Public key record Pointer to X.400/RFC822 information record Geographical position record IPv6 address record Location record Next record Server record ATM address (ATMA) record TKEY resource record secret key transaction authentication (TSIG) record Reserved. Reserved. Reserved. Reserved. All records Any records WINS record Windows Internet Name Service reverse-lookup record Windows Internet Name Service reverse-lookup record Represents a collection of servers by hostname or ip address. Represents a collection of DNS servers that were specified as hostnames or ip addresses. Regardless of the way the server was entered, it is resolved to an object internally. Creates a new instance of the collection. This initializer creates an instance of the collection. The collection will be empty and contain 0 items. Adds a new hostname or ip address representing a DNS server to the collection. The ip address or hostname of a DNS server to add to the collection Adds a DNS server to the collection. The hostname or ip address is first resolved to one or more instances and then added to the collection. If a given hostname resolves to 10 ip addresses, those 10 addresses will be added to the collection. Gets the instance found at the current index of the collection. Gets the at the specified index of the collection. The index of the to retrieve from the collection. The at the specified index. Represents a container for a DNS record of any type The property's value helps determine what type real type of the property returns as noted in this chart: RecordType RecordData A CNAME MB MD MF MG MR NS PTR HINFO ISDN X25 MINFO RP MX AFSDB RT NULL SOA WKS AAAA ATMA NBSTAT SRV TKEY TSIG WINS LOC AXFR null GPOS null IXFR null KEY null MAILA null MAILB null NSAP null NSAPPTR null NXT null PX null SIG null TEXT null Gets or sets the type of DNS record contained in the property. This property indicates the type of DNS record that the property is holding. Gets or sets the DNS record object as denoted in the field. This property holds the actual DNS record. Determines whether or not this instance is equal to a specific by comparing the property of the current against the argument. The to compare to. A boolean indicating whether or not this object contains a DNS record matching the entered type. Determines if this is of a specific . The comparison does not test the field. Determines whether or not this instance is equal to another or to a instance. The object to compare to this instance. A boolean indicating whether or not this object equals the entered object. Determines if this instance is equal to an object. If the object is a , the method is used to determine equality based on the record type. If the object is a object, the method is used to determine equality. If the object is any other type, the class's Equal method is used for comparison. Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table. Integer value representing the hashcode of this instance of . The GetHashCode method uses the hash codes of the and properties to generate a unique code for this particular record type/data combination. Compares the current instance with another object of the same type. The object to compare with this instance. A 32-bit signed integer that indicates the relative order of the comparands. The return value has these meanings: Value Meaning Less than zero This instance is less than obj. The types do not match. Zero This instance is equal to obj. Greater than zero This instance is greater than obj. The do not match. Compares a to this instance by its and properties. obj is not the same type as this instance. Represents a collection of objects. The DnsWrapperCollection is a collection of objects. The resultant collection represents all of the DNS records for the given domain that was looked up. This class cannot be directly created - it is created by the and classes to hold the returned DNS records for the given domain. Gets the at the specified ordinal in the collection Gets the at the specified index of the collection. The index to retrieve from the collection. The at the specified index of the collection. Represents one DNS request. Allows for a complete DNS record lookup on a given domain using the Windows API. The DnsRequest class represents a complete DNS request for a given domain on a specified DNS server, including all options. The DnsRequest class uses the Windows API to do the query and the dlls used are only found on Windows 2000 or higher machines. The class will throw a exception if run on an machine not capable of using the APIs that are required. Version Information 3/8/2003 v1.1 (C#) - Released on 5/31/2003 Created by: Bill Gearhart. Based on code by Patrik Lundin. See version 1.0 remarks below. Specific attention was given to the exposed interface which got a 110% overhaul. Notable changes from the previous version: structs filled with constants were changed to enums .net datatypes were changed to c# datatypes every object is now in it's own *.cs file custom collections and exceptions added better object orientation - request and response classes created for the dns query request/response session so that it follows the .NET model eliminated duplicate recs returned by an ALL query bad api return code enumeration added ToString() overridden to provide meaningful info for many of the dns data structs documentation and notes were created for all classes added check to ensure code only runs on w2k or better obsolete DNS record types are now marked as such newer enum values added to DnsQueryType enum compiled html documentation was written which always takes 20 times longer than writing the code does. this list of changes was compiled by your's truly... smoothed out object and member names so they were more intuitive - for instance: DNS_MX_DATA became MXRecord added call to DnsRecordListFree API to free resources after DnsQuery call altered DnsQuery API call to allow for servers other than the local DNS server from being queried 4/15/2002 v1.0 (C#) Created by: Patrik Lundin Based on code found at: http://www.c-sharpcorner.com/Code/2002/April/DnsResolver.asp Initial implementation. Use the and objects together to get DNS information for aspemporium.com from the nameserver where the site is hosted. using System; using netlib.Dns; using netlib.Dns.Records; namespace ClassLibrary1 { class __loader { static void Main() { try { DnsRequest request = new DnsRequest(); request.TreatAsFQDN=true; request.BypassCache=true; request.Servers.Add("dns.compresolve.com"); request.Domain = "aspemporium.com"; DnsResponse response = request.GetResponse(); Console.WriteLine("Addresses"); Console.WriteLine("--------------------------"); foreach(ARecord addr in response.ARecords) Console.WriteLine("\t{0}", addr.ToString()); Console.WriteLine(); Console.WriteLine("Name Servers"); Console.WriteLine("--------------------------"); foreach(PTRRecord ns in response.NSRecords) Console.WriteLine("\t{0}", ns.ToString()); Console.WriteLine(); Console.WriteLine("Mail Exchanges"); Console.WriteLine("--------------------------"); foreach(MXRecord exchange in response.MXRecords) Console.WriteLine("\t{0}", exchange.ToString()); Console.WriteLine(); Console.WriteLine("Canonical Names"); Console.WriteLine("--------------------------"); foreach(PTRRecord cname in response.GetRecords(DnsRecordType.CNAME)) Console.WriteLine("\t{0}", cname.ToString()); Console.WriteLine(); Console.WriteLine("Start of Authority Records"); Console.WriteLine("--------------------------"); foreach(SOARecord soa in response.GetRecords(DnsRecordType.SOA)) Console.WriteLine("\t{0}", soa.ToString()); Console.WriteLine(); //foreach(DnsWrapper wrap in response.RawRecords) //{ // Console.WriteLine(wrap.RecordType); //} response = null; request = null; } catch(DnsException ex) { Console.WriteLine("EXCEPTION DOING DNS QUERY:"); Console.WriteLine("\t{0}", ((DnsQueryReturnCode) ex.ErrorCode).ToString("g")); if (ex.InnerException != null) Console.WriteLine(ex.InnerException.ToString()); } } } } http://msdn.microsoft.com/library/en-us/dns/dns/dnsquery.asp http://msdn.microsoft.com/library/en-us/dns/dns/dnsrecordlistfree.asp Gets a collection of DNS servers to use for the current request. If the collection contains no items, the local DNS servers are used. If the collection contains 0 references, the default DNS servers are used. Otherwise, servers are used in a decending order from their ordinal position in the collection. You can add as many DNS Servers as you need to the collection by host name or IP address. A that can be used to manage the DNS servers that will be used for the query. Gets or sets whether or not to use TCP only for the query. Boolean indicating whether or not to use TCP instead of UDP for the query If set to true, the DNS query will be done via TCP rather than UDP. This is useful if the DNS service you are trying to reach is running on TCP but not on UDP. Gets or sets whether or not to accept truncated results — does not retry under TCP. Boolean indicating whether or not to accept truncated results. Determines wherher or not the server will be re-queried in the event that a response was truncated. Gets or sets whether or not to perform an iterative query Boolean indicating whether or not to use recursion to resolve the query. Specifically directs the DNS server not to perform recursive resolution to resolve the query. Gets or sets whether or not to bypass the resolver cache on the lookup. This must be set to true if you specified a server in the collection. Boolean indicating whether or not to bypass the cache and use the list of servers in the collection. Setting this to true allows you to specify one or more DNS servers to query instead of querying the local DNS cache and server. If false is set, the list of servers is ignored and the local DNS cache and server is used to resolve the query. Gets or sets whether or not to direct DNS to perform a query on the local cache only Boolean indicating whether or not to only use the DNS cache to resolve a query. This option allows you to query the local DNS cache only instead of making a DNS request over either UDP or TCP. This property represents the logical opposite of the property. Gets or sets whether or not to direct DNS to perform a query using the network only, bypassing local information. Boolean indicating whether or not to use the network only instead of local information. This property represents the logical opposite of the property. Gets or sets whether or not to direct DNS to ignore the local name. Boolean indicating whether or not to ignore the local name. Determines how the DNS query handles local names. Gets or sets whether or not to prevent the DNS query from consulting the HOSTS file. Boolean indicating whether or not to deny access to the HOSTS file when querying. Determines how the DNS query handles accessing the HOSTS file when querying for DNS information. Gets or sets whether or not to prevent the DNS query from using NetBT for resolution. Boolean indicating whether or not to deny access to NetBT during the query. Determines how the DNS query handles accessing NetBT when querying for DNS information. Gets or sets whether or not to direct DNS to return the entire DNS response message. Boolean indicating whether or not to return the entire response. Determines how the DNS query expects the response to be received from the server. Gets or sets whether or not to prevent the DNS response from attaching suffixes to the submitted name in a name resolution process. Boolean indicating whether or not to allow suffix attachment during resolution. Determines how the DNS server handles suffix appending to the submitted name during name resolution. Gets or sets whether or not to store records with the TTL corresponding to the minimum value TTL from among all records Boolean indicating whether or not to use TTL values from all records. Determines how the DNS query handles TTL values. Gets or sets the domain to query. The domain must be a hostname, not an IP address. This method is expecting a hostname, not an IP address. The system will fail with a when is called if Domain is an IP address. String representing the domain that DNS information is desired for. This should be set to a hostname and not an IP Address. Creates a new instance of The property is set to null and all other properties have their default value of false, except for which has a value of true. The system is set to use the local DNS server for all queries. Creates a new instance of The property is set to the domain argument and all other properties have their default value of false, except for which has a value of true. The system is set to use the local DNS server for all queries. The hostname that DNS information is desired for. This should not be an ip address. For example: yahoo.com Queries the local DNS server for information about this instance of and returns the response as a A object containing the response from the DNS server. The code is running on a machine older than Windows 2000 The property is null The DNS query itself failed or parsing of the returned response failed Returns a representing the response from the DNS server or one of the exceptions noted in the exceptions area, the most common of which is the . Represents one DNS response. This class cannot be directly created - it is returned by the method. The DnsResponse class represents the information returned by a DNS server in response to a . The DnsResponse class offers easy access to all of the returned DNS records for a given domain. Gets a containing all of the DNS information that the server returned about the queried domain. Returns all of the DNS records retrieved about the domain as a . This property is wrapped by the method, the , , and properties. Gets a collection of objects. Returns a collection of DNS records of a specified . The collection's data type is determined by the type of record being sought in the type argument. A enumeration value indicating the type of DNS record to get from the list of all DNS records (available in the property. an of one of the types specified in the namespace based on the argument representing the type of DNS record desired. It is recommended that you loop through the results of this method as follows for maximum convenience: foreach ( record in obj.GetRecords()) { string s = record.ToString(); } The following table indicates the DNS record type you can expect to get back based on the requested. Any items returning null are not currently supported. DnsRecordType enumeration value GetRecords() returns A CNAME MB MD MF MG MR NS PTR HINFO ISDN X25 MINFO RP MX AFSDB RT NULL SOA WKS AAAA ATMA NBSTAT SRV TKEY TSIG WINS LOC AXFR null GPOS null IXFR null KEY null MAILA null MAILB null NSAP null NSAPPTR null NXT null PX null SIG null TEXT null Gets all the for the queried domain. Uses the method to retrieve an array of s representing all the Address records for the domain. An array of objects. Gets all the for the queried domain. Uses the method to retrieve an array of s representing all the Mail Exchanger records for the domain. An array of objects. Gets all the DNS name servers for the queried domain as an array of s. Uses the method to retrieve an array of s representing all the Name Server records for the domain. An array of objects. Represents a DNS Well Known Service record (DNS_WKS_DATA) The WKSRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the IP address IP address, in the form of an IP4_ADDRESS structure. Gets or sets the protocol IP protocol for this record. Valid values are UDP or TCP. Gets or sets the bitmask Mask representing well known service being represented in the RR. Returns a string representation of the service record The string returned looks like: IP Address: [IPADDR] Protocol: [PROTO] BitMask: [BITMASK] where [IPADDR] = string representation of as specified here and [PROTO] = string representation of and [BITMASK] = hexadecimal representation of Represents a DNS Windows Internet Name Service reverse-lookup (WINSR) record (DNS_WINSR_DATA) The WINSRRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the mapping flag WINS mapping flag that specifies whether the record must be included into the zone replication. It may have only two values: 0x80000000 and 0x00010000 corresponding to the replication and no-replication (local record) flags, respectively. Gets or sets the lookup timeout Time, in seconds, that a DNS Server attempts resolution using WINS lookup. Gets or sets the cache timeout Time, in seconds, that a DNS Server using WINS lookup may cache the WINS Server's response. Gets or sets the result domain name Pointer to a string representing the domain name to append to the returned NetBIOS name. Returns a string representation of this record. The string returned looks like: mapping flag: [FLAG] lookup timeout: [LOOKUP] cache timeout: [CACHE] result domain: [DOMAIN] where [FLAG] = string representation of and [LOOKUP] = string representation of and [CACHE] = string representation of and [DOMAIN] = hexadecimal representation of Represents a DNS Windows Internet Name Service (WINS) record (DNS_WINS_DATA) The WINSRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the mapping flag WINS mapping flag that specifies whether the record must be included into the zone replication. It may have only two values: 0x80000000 and 0x00010000 corresponding to the replication and no-replication (local record) flags, respectively. Gets or sets the lookup timeout Time, in seconds, that a DNS Server attempts resolution using WINS lookup. Gets or sets the cache timeout Time, in seconds, that a DNS Server using WINS lookup may cache the WINS Server's response. Gets or sets the count of WINS servers Number of WINS Servers listed in the WinsServers member. Gets or sets the WINS server array pointer Array of WINS Servers, each of type int . Returns a string representation of this record. The string returned looks like: mapping flag: [FLAG] lookup timeout: [LOOKUP] cache timeout: [CACHE] server count: [SERVERCT] server ptr: [SERVERS] where [FLAG] = string representation of and [LOOKUP] = string representation of and [CACHE] = string representation of and [SERVERCT] = string representation of and [SERVERS] = string representation of Represents a DNS Text record (DNS_TXT_DATA) The TXTRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the string count Number of strings represented in pStringArray. Gets or sets the string array Array of strings representing the descriptive text of the TXT resource record. Returns a string representation of this record. The string returned looks like: string count: [COUNT] string array: [ARR] where [COUNT] = string representation of and [ARR] = string representation of represents a secret key transaction authentication (TSIG) record (DNS_TSIG_DATA) The TSIGRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the name algorithm Name of the key used in the domain name syntax. Gets or sets the algorithm packet Pointer to the packet containing the algorithm. Gets or sets the key Pointer to the signature. Gets or sets the other data Pointer to other data. This member is empty unless a BADTIME error is returned. Gets or sets the create time Time the key transaction authentication was created, expressed in seconds since the beginning of January 1, 1970, Greenwich Mean Time (GMT), excluding leap seconds. Gets or sets the fudge time Time, in seconds, from which the i64CreateTime may be in error. Gets or sets the original XID Original message identifier. Gets or sets the error Error, expressed in expanded RCODE that covers TSIG processing. See Remarks for more information about the TSIG resource record. Gets or sets the key length Length, in bytes, of the pSignature member. Gets or sets the other length Length, in bytes, of the pOtherData member. Gets or sets the algorithm length Length, in bytes, of the pNameAlgorithm member. Gets or sets whether or not to use packet pointers Reserved for future use. Represents a DNS TKEY resource record, used to establish and delete shared-secret keys between a DNS resolver and server. (DNS_TKEY_DATA) The TKEYRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the name algorithm Pointer to a string representing the name of the algorithm used with the key. Gets or sets the algorithm packet. Pointer to the packet containing the algorithm. Gets or sets the key Pointer to the key. Gets or sets the other data Reserved for future use. Gets or sets the create time Date and time at which the key was created, expressed in seconds since the beginning of January 1, 1970, Greenwich Mean Time (GMT), excluding leap seconds. Gets or sets the expire time Expiration date of the key, expressed in seconds since the beginning of January 1, 1970, Greenwich Mean Time (GMT), excluding leap seconds. Gets or sets the mode Scheme used for key agreement or the purpose of the TKEY DNS Message. Gets or sets the error Error, expressed in expanded RCODE that covers TSIG processing and TKEY processing. See Remarks. Gets or sets the key length Length, in bytes, of the pSignature member. Gets or sets the other length Length, in bytes, of the pOtherData member. Gets or sets the name algorithm's length Length, in bytes, of the pNameAlgorithm member. Gets or sets whether or not to use packet pointers Reserved for future use. Represents a DNS Server record. (DNS_SRV_DATA) The SRVRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the name Pointer to a string representing the target host. Gets or sets the priority Priority of the target host specified in the owner name. Lower numbers imply higher priority. Gets or sets the weight Weight of the target host. Useful when selecting among hosts with the same priority. The chances of using this host should be proportional to its weight. Gets or sets the port Port used on the target host for the service. Reserved. Reserved. Used to keep pointers DWORD aligned. Returns a string representation of this record. The string returned looks like: name next: [SERVER] priority: [PRIOR] weight: [WEIGHT] port: [PORT] where [SERVER] = string representation of and [PRIOR] = string representation of and [WEIGHT] = string representation of and [PORT] = string representation of Represents a DNS Start Of Authority record (DNS_SOA_DATA) The SOARecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the primary server Pointer to a string representing the name of the authoritative DNS server for the zone to which the record belongs. Gets or sets the name of the administrator Pointer to a string representing the name of the responsible party for the zone to which the record belongs. Gets or sets the serial number Serial number of the SOA record. Gets or sets the refresh Time, in seconds, before the zone containing this record should be refreshed. Gets or sets the retry count Time, in seconds, before retrying a failed refresh of the zone to which this record belongs Gets or sets the expiration Time, in seconds, before an unresponsive zone is no longer authoritative. Gets or sets the default ttl Lower limit on the time, in seconds, that a DNS server or caching resolver are allowed to cache any RRs from the zone to which this record belongs. Returns a string representation of the Start Of Authority record. The string returned looks like: administrator: [ADMIN] TTL: [TTL] primary server: [SERVER] refresh: [REFRESH] retry: [RETRY] serial number: [SERIAL] where [ADMIN] = string representation of and [TTL] = string representation of and [SERVER] = string representation of and [REFRESH] = string representation of and [RETRY] = string representation of and [SERIAL] = string representation of Represents a DNS Cryptographic signature record. (DNS_SIG_DATA) The SIGRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the signer. Pointer to a string representing the name of the signer that generated the record Gets or sets the type covered Type of RR covered by the signature Gets or sets the algorithm Algorithm used with the key specified in the RR. The assigned values are shown in the following table. Value Meaning 1 RSA/MD5 (RFC 2537) 2 Diffie-Hellman (RFC 2539) 3 DSA (RFC 2536) 4 Elliptic curve cryptography Gets or sets the label count Number of labels in the original signature RR owner name. The count does not include the NULL label for the root, nor any initial wildcards. Gets or sets the original ttl TTL value of the RR set signed by the signature RR. Gets or sets the expiration Expiration date, expressed in seconds since the beginning of January 1, 1970, Greenwich Mean Time (GMT), excluding leap seconds. Gets or sets the time signed Date and time at which the signature becomes valid, expressed in seconds since the beginning of January 1, 1970, Greenwich Mean Time (GMT), excluding leap seconds. Gets or sets the key tag Method used to choose a key that verifies a signature. See RFC 2535, Appendix C for the method used to calculate a KeyTag. Reserved. Reserved. Used to keep byte field aligned. Gets or sets the signature Signature, represented in base 64, formatted as defined in RFC 2535, Appendix A. Represents the DNS pointer record (DNS_PTR_DATA) The PTRRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the hostname of the record. Pointer to a string representing the pointer (PTR) record data. Returns a string representation of the pointer record. The string returned looks like: Hostname: [HOST] where [HOST] = string representation of Represents the DNS Next record. (DNS_NXT_DATA) The NXTRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the name. Pointer to a string representing the name of the next domain. Gets or sets the type bit map Number of elements in the wTypes array. Returns a string representation of this record. The string returned looks like: next: [NAME] type bitmap: [BITMAP] where [NAME] = string representation of and [BITMAP] = hexadecimal representation of Represents NULL data for a DNS resource record. (DNS_NULL_DATA) The NULLRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the byte count. Number of bytes represented in Data. Gets or sets the data. Null data. Returns a string representation of this record. The string returned looks like: byte count: [BYTECT] data: [DATA] where [BYTECT] = string representation of and [DATA] = hexadecimal representation of Represents a DNS Mail Exchange record (DNS_MX_DATA). The MXRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the exchange's host name Pointer to a string representing the fully qualified domain name (FQDN) of the host willing to act as a mail exchange. Gets or sets the preference of the exchange. Preference given to this resource record among others at the same owner. Lower values are preferred. Reserved. Reserved. Used to keep pointers DWORD aligned. Returns a string representation of this mail exchange. The string returned looks like: exchange (preference): [EXCH] ([PREF]) where [EXCH] = string representation of and [PREF] = hexadecimal representation of Represents a DNS mail information (MINFO) record (DNS_MINFO_DATA) The MINFORecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the mailbox name Pointer to a string representing the fully qualified domain name (FQDN) of the mailbox responsible for the mailing list or mailbox specified in the record's owner name. Gets or sets the error mailbox name Pointer to a string representing the FQDN of the mailbox to receive error messages related to the mailing list. Returns a string representation of this record. The string returned looks like: mailbox: [MAILBOX] error mailbox: [ERRMAILBOX] where [MAILBOX] = string representation of and [ERRMAILBOX] = hexadecimal representation of Represents a DNS Location record (DNS_LOC_DATA) The LOCRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. For , altitude above or below sea level may be used as an approximation of altitude relative to the [WGS 84] spheroid, however, there will be differences due to the Earth's surface not being a perfect spheroid. For example, the geoid (which sea level approximates) for the continental US ranges from 10 meters to 50 meters below the [WGS 84] spheroid. Adjustments to and/or will be necessary in most cases. The Defense Mapping Agency publishes geoid height values relative to the [WGS 84] ellipsoid. For more information about the LOC RR, see RFC 1876. Gets or sets the version Version number of the representation. Must be zero. Gets or sets the size Diameter of a sphere enclosing the described entity, in centimeters, expressed as a pair of four-bit unsigned integers, each ranging from zero to nine, with the most significant four bits representing the base and the second number representing the power of ten by which to multiply the base. This format allows sizes from 0e0 (<1cm) to 9e9 (90,000km) to be expressed. Gets or sets the horizontal precision Horizontal precision of the data, in centimeters, expressed using the same representation as wSize. This is the diameter of the horizontal circle of error, rather than a plus or minus value. Matches the interpretation of wSize; to get a plus or minus value, divide by 2. Gets or sets the vertical precision Vertical precision of the data, in centimeters, expressed using the same representation as wSize. This value represents the total potential vertical error, rather than a plus or minus value. Matches the interpretation of wSize; to get a plus or minus value, divide by 2. If altitude above or below sea level is used as an approximation for altitude relative to the [WGS 84] ellipsoid, the precision value should be adjusted. Gets or sets the latitude of the location Latitude of the center of the sphere described by wSize, expressed as a 32-bit integer, with the most significant octet first (network standard byte order), in thousandths of a second of arc. 2^31 represents the equator, larger numbers are north latitude. Gets or sets the longitude of the location Longitude of the center of the sphere described by wSize, expressed as a 32-bit integer, most significant octet first (network standard byte order), in thousandths of a second of arc, rounded away from the prime meridian. 2^31 represents the prime meridian, larger numbers are east longitude.. Gets or sets the altitude of the location Altitude of the center of the sphere described by wSize, expressed as a 32-bit integer, most significant octet first (network standard byte order), in centimeters, from a base of 100,000m below the [WGS 84] reference spheroid used by GPS (semimajor axis a=6378137.0, reciprocal flattening rf=298.257223563). See Remarks for more information. Represents a Public key DNS record (DNS_KEY_DATA) The KEYRecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the flags Flags used to specify mapping, as described in IETF RFC 2535. Gets or sets the protocol Protocol for which the key specified in the resource record can be used. The assigned values are shown in the following table. Value Meaning 1 TLS 2 E-Mail 3 DNSSEC 4 IPSec 255 All protocols Gets or sets the algorithm Algorithm used with the key specified in the resource record. The assigned values are shown in the following table. Value Meaning 1 RSA/MD5 (RFC 2537) 2 Diffie-Hellman (RFC 2539) 3 DSA (RFC 2536) 4 Elliptic curve cryptography Gets or sets the key Public key, represented in base 64 as described in Appendix A of RFC 2535. Returns a string representation of this record. The string returned looks like: flags: [FLAGS] protocol: [PROTO] algorithm: [ALGOR] key: [KEY] where [FLAGS] = string representation of and [PROTO] = hexadecimal representation of and [ALGOR] = string representation of and [KEY] = hexadecimal representation of Represents a DNS Address record (DNS_A_DATA) The ARecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the ip address. IPv4 address, in the form of an uint datatype. could be used to fill this property. Returns a string representation of the A Record The string returned looks like: ip address: [ADDRESS] where [ADDRESS] = Represents a IPv6 Address record (DNS_AAAA_DATA) The AAAARecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the ip6 address IPv6 address, in the form of an structure. returns a string representation of this AAAA record. The string returned looks like: Address: [ADDRESS] where [ADDRESS] = Represents a DNS ATM address (ATMA) record (DNS_ATMA_DATA) The ATMARecord structure is used in conjunction with the and classes to programmatically manage DNS entries. Gets or sets the address type ATM address format. Two possible values are DNS_ATMA_FORMAT_E164 or DNS_ATMA_FORMAT_AESA. Gets or sets the address ATM address. For E164, represents a NULL-terminated string of less than DNS_ATMA_MAX_ADDR_LENGTH. For AESA, its length is exactly DNS_ATMA_AESA_ADDR_LENGTH. Returns a string representation of this record. The string returned looks like: address type: [TYPE] address: [ADDRESS] where [TYPE] = hexadecimal representation of and [ADDRESS] = string representation of Reports system binary compatibility readings. This affects generations of netfx behavior (sorting, URI escaping, etc — look for usages of the class reported here). Reads internal flags (if possible, shan't throw) and dumps in a structured text format. Mostly for dumping into tests for now. Gets GAC subfolder names under the CLR2 GAC root dir. Gets GAC subfolder names under the CLR4 GAC root dir. Windows, OS wide, .NET Frameworks installed on this machine. Current system bitness Current system when running 32 bits, Wow on 64 bits. discovers reference assemblies starting from 3.5 client profile. Instance of mono installation. Every mono instance is equivalent to the whole .net framework on windows. .kproj (ASP.NET 5.0 projects) may target different frameworks using different project properties and reference sets. The class is used to support it. Docs: https://docs.nuget.org/create/targetframeworks (general) https://github.com/dotnet/corefx/blob/master/Documentation/architecture/net-platform-standard.md (portable profiles) https://docs.microsoft.com/en-us/dotnet/articles/standard/library RSRP-459103 contains quite a few links and comments about it Xamarin/ Android: https://docs.microsoft.com/en-us/nuget/schema/target-frameworks netstandard: https://github.com/dotnet/standard/blob/master/docs/versions.md This is a temporary value used while refactoring. And now we have 300+ usages forever. DNX 4.5.1 is allowed to reference regular projects unlike all other combinations Helper class to detect TargetFrameworkId from Roslyn project Find .NET Framework version string in the registry. .NET Framework 4.5 and later. Find .NET Framework release number in the registry. .NET Framework 4.5 and later. Get .NET Framework version by release number. .NET Framework 4.5 and later. See "https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed". Represents registry "Version" and "Release" keys that are necessary to built marketing version of .NET framework https://msdn.microsoft.com/en-us/library/hh925568.aspx Raw value of "Version" registry key Raw value of "Release" registry key Represents the result of an attempt to make files writable All files were successfully made writable The attempt failed for some files Some files were modified as a result of the attempt to make them writable Cancelled by user Base class for all enum patterns Creates an application domain, destroys on termination of the lifetime. Duration. Base name for the appdomain, an unique suffix would be added. Params, wrapped in a custom type so that this declaration could be accessible both in NetFX and NetCore. Params. Calls the given ctor expression in the target appdomain, sending the given arguments. The argument instances cross the domain boundary according to their serialization/marshalling, safe if all of mscorlib types. If not for the reference you have to use in the Expression, it would have been fully isolated, meaning the same assembly does not have to be loaded into both. With an expression, obviously you need the type, but if you supply another path, it might be two different versions. If you take the code inside and call it manualy on strings and args without the help of the expression, then it would be fully isolated. Calling ctor is the only option to do so — managed APIs do not allow to call static methods without cross-loading assemblies in both appdomains, just ctors. Unfortunately, a ctor cannot return anything, assuming we cannot unwrap the object itself (and load its assembly): it ain't got any return value, and any ref/out parameters are NOT marshalled back. Creates an application domain, executes the action, destroys the appdomain. Base name for the appdomain, an unique suffix would be added. Runs arbitrary code with the new appdomain. Appdomain is destoryed when the function completes. Params, wrapped in a custom type so that this declaration could be accessible both in NetFX and NetCore. Params. Converts value string to it Windows representation. as a byte-encoded string. Encoding algorithm adds "/" character to capital letters, i.e. "A" is encoded as "/A". Character '\' is encoded as '//', '/' is encoded as '\'. Then encoding scheme similar to jdk's native2ascii converter is used to convert java string to a byte array of ASCII characters. Converts value string from its Windows representation to java string. See {@link #toWindowsValueString(String) toWindowsValueString()} for the description of the encoding algorithm. Extra diag for cases like RSRP-499395 startIndex cannot be larger than length of string. (Parameter 'startIndex') My wild guess is that we were falling back to CurrentCulture finds when culture wasn't specified (now I'm updating this to Ordinal because mostly we use this for technical delimiters anyway, and Current has too many surprises), but the faulty code really does technical delimiters only. Represents a ZIP file entry as an immutable file item. You MUST NOT use the returned stream beyond the lifetime (pass it as the to ensure). When used in the build system, this usually means opening zip files eternally (by GC). If the ZIP entry is not compressed, it's a direct view over the parent stream of the ZIP. Make sure it's immutable as well. If the entry is compressed, then it's lazy-decompressed up to the requested bytes. Beware that if the entry is also a nested ZIP file, then opening it would require reading the end of the file, for the dictionary. For a ZIP file entry, gets an immutable clonable stream over its body. You MUST NOT use the returned stream beyond the lifetime. When used in the build system, this usually means opening zip files eternally (by GC). If the ZIP entry is not compressed, it's a direct view over the parent stream of the ZIP. Make sure it's immutable as well. If the entry is compressed, then it's lazy-decompressed up to the requested bytes. Beware that if the entry is also a nested ZIP file, then opening it would require reading the end of the file, for the dictionary. Allows to pass a return value thru a void-result . Suppose the following piece of code that should be surrounded with some pre- and post-activity: int GetResult() { return 5; } If the activity is available as an , the code is surrounded with using without any problem with return statement: int GetResult() { using(EnterScope()) { return 5; } } Suppose that the surrounding activity is implemented as a function that takes an to execute in the scope (e.g. ): int GetResult() { ExecuteInScope(delegate { return 5; // Compilation error }); } This won't compile, because ExecuteInScope is void and the action that it takes to execute is also void. A temp local variable could be an option to use it for assignment, but it's hard to maintain in case the inner action has multiple returns against various code paths. This function wraps the ExecuteInScope call and gives you a functor that turns your int-returning inner code into a void action suitable for the executor: int GetResult() { return FEx.Return<int>(FR => ExecuteInScope(FR(() => { return 5; }))); } Helper for reading and writing throw-away files (if the content is corrupted or there's an error reading it, it can be safely dropped and re-created (False result reported to caller). FolderContentCache is an utility class intended to use for folders that are - never deleted - seldom change The cache should be cleared by it's creator. Produces the default assembly binding redirections for a product assembly. Attribute names. Element names. Namespace aliases. XML Namespaces. Constructor for TokenizerHelper which accepts an IFormatProvider. If the IFormatProvider is null, we use the thread's IFormatProvider info. We will use ',' as the list separator, unless it's the same as the decimal separator. If it *is*, then we can't determine if, say, "23,5" is one number or two. In this case, we will use ";" as the separator. The string which will be tokenized. The IFormatProvider which controls this tokenization. Initialize the TokenizerHelper with the string to tokenize, the char which represents quotes and the list separator. The string to tokenize. The quote char. The list separator. Initialize the TokenizerHelper with the string to tokenize, the char which represents quotes and the list separator. The string to tokenize. The quote char. The list separator. Throws an exception if there is any non-whitespace left un-parsed. Advances to the NextToken true if next token was found, false if at end of string Advances to the NextToken true if next token was found, false if at end of string Advances to the NextToken. A separator character can be specified which overrides the one previously set. true if next token was found, false if at end of string Advances to the NextToken, throwing an exception if not present The next token found Advances to the NextToken, throwing an exception if not present The next token found Setting GC to LowLatency mode will force the GC to use NonConcurrent collection mode in some circumstances: RSRP-479493 These methods are intentionally hidden to avoid such problems in future. If you are going to tweak any GC params please elaborate your desicion in public discussion with your team. Cached caller for generic interface on untyped objects. Caches call info so that not to use reflection when working on known types. Pre-calculated reflection object of , for making a delegate off it. Cache fn. Cache fn. Cache. Thread-static to avoid concurrency issues. Cache. Thread-static to avoid concurrency issues. Cached caller for generic interface on untyped objects. Caches call info so that not to use reflection when working on known types. This is tested for interface. This is passed into the of the first parameter, if matches the generic type. NULL, if either does not implement , or none of its can take as a parameter. The call result, otherwise. Generic params of all the interfaces on this type. Cached per type per thread. Creates a delegate for calling of a certain type without reflection. Cached per type per thread. Helper method to lift the genericity off the , so that it could be cached and called with objects. Delegate for . Indicates that this class/property is immutable (you can't change its inner state with field assignments, setters, indexers, method calls an so on) an therefore safe for multithreaded usage. If certain methods of class are thread-unsafe (e.g. iterators in synchronized dictionaries), you can annotate this methods with Compares elements by their positions in an ArrayList Assumes the parameter is a COM object's RCW, or a managed COMable object. Does QueryInterface for IUnknown on it and returns the raw IUnknown pointer, which also adds one more reference on the object. Specifies the DPI resolution of some device, or device-independent 96 DPI. Being two-dimensional, resolution is not well-suited for linear comparison. But in the real world they're almost always uniform, so it's still sane to have them comparable. Gets the WPF-standard device-independent resolution of 96x96 DPI. Use this as a temporary placeholder when you're not sure which resolution is in effect. Such cases should be adressed later. Gets the resolution along the X-axis. Note that for an uninitialized structure this returns the device-independent DPI of 96. Gets the resolution along the X-axis. Note that for an uninitialized structure this returns the device-independent DPI of 96. Turns an int length into an Avalon double length, converting max-int to corresponding infinities. Turns a float length into a double, Inf values are automatically OK. Gets the system-wide boot-time (or logon-time) screen DPI which does not reflect dynamic and per-monitor DPI changes. An exception upon the process exit code (ERRORLEVEL) indicating an error. Returns a string with this error level representations: hex, dec unsigned, dec signed, HRESULT names of this value, and WinError names of this value. Returns a string with this error level representations: hex, dec unsigned, dec signed, HRESULT names of this value, and WinError names of this value. Manages an unmanaged buffer with a fixed address in the memory. GC can add to final-queue more than once, so track the state. Constructs the object without any allocated memory. Constructs the object and allocates the desired length. The object must then be disposed of, to free the memory. Gets the fixed address of the allocated buffer (safe for passing into unmanaged funcs), throws if not allocated yet. Gets whether the buffer has been allocated, and its and properties can be accessed. Gets the length of the allocated buffer, throws if not allocated yet. Allocates or reallocates the buffer to fit the length specified. No attempts are currently made to minimize the number of resizes. Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. 2 Provides for hooking into the Import Address Table (IAT) of a DLL. Limits the number or items in the list to guard off infinite loops. Installs an Import Address Table (IAT) hook. You choose a function (, ) whose entry will be replaced in the IAT of the specified module () to point to your own implementation () instead. Name of the module in which the function-to-be-hooked is defined. Example: USER32.DLL. Name of the function to be hooked. Example: SystemParametersInfoW. Note that for the functions that have separate ANSI and Wide versions you must include a suffix in the function name. Must have the stdcall (WINAPI, PASCAL) calling convention. The module whose IAT is to be patched. Its calls to the Function will be intercepted. The new implementation to replace the Function, in view of . The hook will hold a reference on the delegate. Note that it's up to you to provide the appropriate signature of the delegate, which must match the one of the Function. Pay attention to the charset and bitness issues. Installs an Import Address Table (IAT) hook. You choose a function (, ) whose entry will be replaced in the IAT of the specified module () to point to your own implementation () instead. Name of the module in which the function-to-be-hooked is defined. Example: USER32.DLL. Name of the function to be hooked. Example: SystemParametersInfoW. Note that for the functions that have separate ANSI and Wide versions you must include a suffix in the function name. Must have the stdcall (WINAPI, PASCAL) calling convention. The module whose IAT is to be patched. Its calls to the Function will be intercepted. Must be loadable with LoadLibrary (or already loaded). The new implementation to replace the Function, in view of . The hook will hold a reference on the delegate. Note that it's up to you to provide the appropriate signature of the delegate, which must match the one of the Function. Pay attention to the charset and bitness issues. Impl for the Install family functions. MUST be specified, while its name is optional (for diag). Throw on GetLastError. Ensures the delegate would not be ever collected. Personal declarations for the WinAPI calls. Not shared with WinAPI.Interop, as there're pointers where applicable instead of intptrs. Was written to be compatible with ANSI/Wide charsets and 32/64 bit systems. It's DWORD in 32bit and ULONGLONG in 64bit, so use void* for both. Yes, there's only one field unioned in there. Encapsulates a native DLL module. Use to get instances of this class. The DLL module handle. The absolute path to the DLL file on disk. Internal constructor. Used by . The table of loaded DLL entry points. Gets a delegate instance for the specified DLL entry point. The delegate type a DLL entry point to be converted to. The name of a DLL entry point. Returns a function pointer for the specified DLL entry point. The result can be used to create C# 9.0+ "Function Pointer". See https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/proposals/csharp-9.0/function-pointers The name of a DLL entry point. Creates an instance of a COM object without the Registry information, by invoking its class factory. CLSID of the object to create. Creates an instance of a COM object without the Registry information, by invoking its class factory. The type of the object to create. A delegate for the DllGetClassObject function. A wrapper for an instance of a COM object created by . The instance of a COM object. CLSID of the object. Casts the object to the specified interface type. Helps to load and work with native DLL modules. Calling LoadLibrary increments the reference count. Calling the FreeLibrary or FreeLibraryAndExitThread function decrements the reference count. The system unloads a module when its reference count reaches zero or when the process terminates (regardless of the reference count). Nothing special Debug version of dlls Loads the DLL module and returns an instance of class. Lifetime. The name of a DLL to load. See Loads the DLL module and returns an instance of class. Lifetime. The name of a DLL to load. Root directory where native DLL are placed See NOTE: for now, only uses , does not check file existence. NOTE: for now, only uses , does not check file existence. Loads the DLL module and returns an instance of class. Unlike the , does not apply the DLL location and suffices logic, but expects the have the exact DLL path here. Lifetime. The exact file name of a DLL to load. Returns the full path for DLLs of the specified processor architecture ("current assembly directory"\"processor architecture subdirectory"). Root folder for per-RID subfolder lookup, in case a custom folder hasn't been specified from outside. TODO: consider all BinDir folders, i.e. all local install folders from all packages (example: Rider Plugins installed to additional deployed packages folders) This only takes the "core bindir" which would work for _most_ cases. Clients pass their custom folder sometimes, but actually clients DO NOT know which folder to use, they work by assumption => should try all application packages. The specific folder where we should be looking up the DLL (unlike which are just instructions). OFF: RTM version of native Profiler DLLs, and just regular versions of everything else. ON: DEBUG version of native Profiler DLLs; for third-parties, would fail to find them. How folder/file naming accommodates for RID. The specific folder where we should be looking up the DLL (unlike which are just instructions). OFF: RTM version of native Profiler DLLs, and just regular versions of everything else. ON: DEBUG version of native Profiler DLLs; for third-parties, would fail to find them. How folder/file naming accommodates for RID. OFF: RTM version of native Profiler DLLs, and just regular versions of everything else. ON: DEBUG version of native Profiler DLLs; for third-parties, would fail to find them. How folder/file naming accommodates for RID. Flag in {BinDir}, rid is in naming variations of the DLL file suffix. JB Gen2 convention: {BinDir}/{rid[.postfix][.dbg]} NuGet runtimes convention: {BinDir}/runtimes/{rid}/native Tries to break out of virtualization which limits the observed OS version number to the compatibility setting declared in the app manifest. This method should return the true OS version whenever possible. Shell link file extension. Shell link file extension. Creates a new Shell Link. The location of the newly-created .LNK file. The target this .LNK file will be pointing to. Given a path to an .LNK file, reads the target path of the shell link. The object is live and running. The object is still valid, but has entered the disposal routine. Used to prevent the from reentrancy. The object has been disposed of. Throws out all other information but for the version number. ACHTUNG! might have -1 for components which were omitted when parsing the text version! We might want to change this behavior to real zeroes! Throws out all other information but for the version number. For a semantic version which has only the version number, returns the version number. ACHTUNG! might have -1 for components which were omitted when parsing the text version! We might want to change this behavior to real zeroes! Gets whether this semantic version has no info besides the version number. Utility class for locating and opening files on the current operating system. Opens the specified file using the appropriate command for the current operating system. The file to open. On Linux, this method will open the file using the xdg-open command. On macOS, this method will open the file using the open command. On Windows, this method will open the file using the default program associated with the file type. Opens the specified file using the appropriate command for the current operating system. The file path to open. On Linux, this method will open the file using the xdg-open command. On macOS, this method will open the file using the open command. On Windows, this method will open the file using the default program associated with the file type. Opens file explorer and selects(if possible on given OS) passed file Starts logging progress messages with level periodically if the activity wrapped with this method takes long enough, and issues a final message with total time only if any intermediate messages were written. Starts logging progress messages with the given logging level periodically if the activity wrapped with this method takes long enough, and issues a final message with total time only if any intermediate messages were written. Limiting lifetime of the activity. Display name for the activity, would be included within progress messages. Either all-lowercase, or All Title Case recommended, no punctuation at the end. Examples: "Download Packages", "source code compilation". The async payload. Progress messages will be issued while this function is executed or its task is awaited. Optional. An extra suffix sentence for the periodical progress message, would be calculated each time we're about to report it. Might write the number of downloaded bytes and such. Optional. Timeout before issuing the first progress message. If the activity is faster than this, no messages would be issued at all. by default. Optional. Interval between next progress messages. by default. Generate a user friendly object name for logging. Compatible with Focus Monitor. Buttons layout selection for the message box. Note: we're not using either WinForms or Avalon constants for this thing, because they're causing conflicting namespace imports into the code that calls the message box. For instance, importing the System.Windows.Forms namespace in an Avalon component brings much of similarly-named constants into visibility, with the need to qualify names. Icon selection for the message box. Note: we're not using either WinForms or Avalon constants for this thing, because they're causing conflicting namespace imports into the code that calls the message box. For instance, importing the System.Windows.Forms namespace in an Avalon component brings much of similarly-named constants into visibility, with the need to qualify names. Helps to adjust different color parameters in fluent way Makes brighter or darker depending on current brightness. For example, in case of current color is light one, it makes darker Offset The same object to continue adjusting Makes color lighter Offset The same object to continue adjusting Makes color darker Offset The same object to continue adjusting Changes brightness to the target one Target brightness The same object to continue adjusting Changes brightness to the target one Target brightness The same object to continue adjusting Makes the most distinguishable toned lightest color. Note, in case of the color is currently has indistinguishable tone, it will not coerce it (in other word it will try to preserve current level of 'distinguishable') The same object to continue adjusting Makes the most distinguishable lightest color Note, in case of the color is currently has indistinguishable tone, it will not coerce it (in other word it will try to preserve current level of 'distinguishable') The same object to continue adjusting Makes color more saturate Offset The same object to continue adjusting Desaturates color Offset The same object to continue adjusting Changes saturation to the target one Target saturation The same object to continue adjusting Changes saturation to the target one Target saturation The same object to continue adjusting Changes hue Offset to hue The same object to continue adjusting Changes hue to the target one Target hue The same object to continue adjusting Changes hue to the target one Target hue The same object to continue adjusting Multiply current alpha with the given value The same object to continue adjusting Change current opacity to the given one The same object to continue adjusting Add accent from the given color. Technically, result color is hue & saturation from the accent color and brightness from the original How many accented color will be in result color [0..1] Blends with other color How many other color will be in result color [0..1] Set true to mix alpha too Gets helper to adjust different color parameters in fluent way Source color ColorAdjustment Color Management routines. Contains a few simple static functions for working with RGB, BGR and HLS colors. Based in parts on ancient MSDN C++ samples (HLS-RGB conversion). Background for MaxHLS. H, L, and S vary over 0-c_nMaxHLS. Best if divisible by 6. Must fit in a System.Byte. Background for MaxRGB. R, G, and B vary over 0-c_nMaxRGB. Must fit in a . Background for UndefinedHue. Hue is undefined if Saturation is 0 (grey-scale). This value determines where the Hue scrollbar is initially set for achromatic colors. Set tot 2/3 of MaxHLS by default. RGBtoHLS() takes a DWORD RGB value and translates it to HLS BYTEs. A point of reference for the algorithms is Foley and Van Dam, "Fundamentals of Interactive Computer Graphics," Pages 618-19. Their algorithm is in floating point. CHART implements a less general (hardwired ranges) integral algorithm. There are potential round-off errors throughout this sample. ((0.5 + x)/y) without floating point is phrased ((x + (y/2))/y), yielding a very small round-off error. This makes many of the following divisions look strange. The source RGB color. Resulting Hue value. Resulting Luminance value. Resulting Saturation value. Utility routine for HLStoRGB. Converts an HLS color to an RGB color and returns three byte components. Converts HLS to a object. Works just like HLStoRGB, but reverses the return value (BGR DWORD instead of an RGB one). This is useful in case of Windows bitmaps which use BGR colors. Mixes two colors together in the proportion specified. Mixes two colors together in the proportion specified. First color. Second color. A number in between 0.0 and 1.0. The new color. Converts a DWORD RGB color to BGR, or vice versa as it's symmetrical. Mixes two colors Does the same as Mix but for a fixed 1:1 proportion. Blends two colors. Device context to get the nearest color from. May be Null, in which case the exact color is returned. The first color. The second color. The alpha value in the [0…FF] range. The blended color, constrained to the device context or not. Extracts the R value from the RGB color (R is less significant). Extracts the G value from the RGB color (R is less significant). Extracts the B value from the RGB color (R is less significant). Produces an RGB color out of R, G and B values (R is less significant). Produces an RGBA color out of R, G, B, and A values (R is less significant). Produces an RGB color out of R, G and B values (R is less significant). Constrains the integer value to the range of valid HLS values. Makes contrast foreground color (tries to preserve color and make well read foreground)) Currently used background Currently used foreground Desired contrast, difference in lightness between background and foreground (value in range [0..1]) Margin of lightness to avoid color missing, result's lightness will be in range [margin, 1-margin] Determine when we make darker and when lighter (must be in range from margin to 1 - margin) Grayscale coefficients for HDTV luma from ITU-R BT.709: 0.2126, 0.7152, and 0.0722 Grayscale coefficients for HDTV luma from ITU-R BT.709: 0.2126, 0.7152, and 0.0722 Grayscale coefficients for HDTV luma from ITU-R BT.709: 0.2126, 0.7152, and 0.0722 Makes a color similar to the pattern color in terms of brightness Base color Pattern color Differences [0..1] which is appropriate, base color returns in case of difference between base color and pattern less than the threshold Offset, required difference [0..1] from pattern lightness Tries to correct suggested foreground color according to good one Makes darker color than the given one Base color How darker it should be [0..1] Darker color Makes lighter color than the given one Base color How darker it should be [0..N] (for ex., value 0.2 is 20% lighter) Darker color Blend two colors Color a Color b How many of color 'a' in result blended color [0..1] Represents L*a*b* color space Gets an empty CIELab structure. Gets or sets L component (0..100). Gets or sets a component (-100..+100). Gets or sets a component (-100..+100). Represents CIE XYZ color space Gets an empty CIEXYZ structure. Gets the CIE D65 (white) structure. Gets or sets X component. Gets or sets Y component. Gets or sets Z component. Represents CMYK color space. Gets an empty CMYK structure; Creates an instance of a CMYK structure. Provides methods to convert from a color space to an other. Gets the "distance" between two colors. RGB colors must be normalized (eg. values in [0.0, 1.0]). First color red component. First color green component. First color blue component. Second color red component. Second color green component. Second color blue component. Gets the "distance" between two colors. RGB colors must be normalized (eg. values in [0.0, 1.0]). First color [r,g,b] Second color [r,g,b] Gets the "distance" between two colors. First color. Second color. Gets the int equivalent for a hexadecimal value. Converts a Hex color to a .net Color. The desired hexadecimal color to convert. Converts a RGB color format to an hexadecimal color. The Red value. The Green value. The Blue value. Converts a RGB color format to an hexadecimal color. The color to convert. Converts HSB to RGB. The HSB structure to convert. Converts HSB to RGB. Hue value. Saturation value. Brigthness value. Converts HSB to Color. the HSB structure to convert. Converts HSB to a .net Color. Hue value (must be between 0 and 360). Saturation value (must be between 0 and 1). Brightness value (must be between 0 and 1). Converts HSB to Color. Hue value. Saturation value. Brightness value. Converts HSB to HSL. Converts HSB to CMYK. Converts HSB to CMYK. Converts HSL to RGB. Hue, must be in [0, 360]. Saturation, must be in [0, 1]. Luminance, must be in [0, 1]. Converts HSL to RGB. The HSL structure to convert. Converts HSL to .net Color. Converts HSL to .net Color. The HSL structure to convert. Converts HSL to HSB. Converts HSL to CMYK. Converts HSL to YUV. Converts RGB to HSL. Red value, must be in [0,255]. Green value, must be in [0,255]. Blue value, must be in [0,255]. Converts RGB to HSL. Converts Color to HSL. Converts RGB to HSB. Converts RGB to HSB. Converts RGB to HSB. Converts RGB to CMYK Red vaue must be in [0, 255]. Green vaue must be in [0, 255]. Blue vaue must be in [0, 255]. Converts RGB to CMYK Converts RGB to CMYK Converts RGB to YUV. red must be in [0, 255]. green must be in [0, 255]. blue must be in [0, 255]. Converts RGB to YUV. Converts RGB to YUV. Converts RGB to CIE XYZ (CIE 1931 color space) Red must be in [0, 255]. Green must be in [0, 255]. Blue must be in [0, 255]. Converts RGB to CIEXYZ. Converts RGB to CIEXYZ. Converts RGB to CIELab. Converts RGB to CIELab. Converts RGB to CIELab. Converts CMYK to RGB. Cyan value (must be between 0 and 1). Magenta value (must be between 0 and 1). Yellow value (must be between 0 and 1). Black value (must be between 0 and 1). Converts CMYK to RGB. Cyan value (must be between 0 and 1). Magenta value (must be between 0 and 1). Yellow value (must be between 0 and 1). Black value (must be between 0 and 1). Converts CMYK to RGB. Converts CMYK to RGB. Cyan value (must be between 0 and 1). Magenta value (must be between 0 and 1). Yellow value (must be between 0 and 1). Black value (must be between 0 and 1). Converts CMYK to RGB. Converts CMYK to HSL. Converts CMYK to HSB. Converts CMYK to YUV. Converts YUV to RGB. Y must be in [0, 1]. U must be in [-0.436, +0.436]. V must be in [-0.615, +0.615]. Converts YUV to RGB. Converts YUV to a .net Color. Y must be in [0, 1]. U must be in [-0.436, +0.436]. V must be in [-0.615, +0.615]. Converts YUV to a .net Color. Converts YUV to HSL. Y must be in [0, 1]. U must be in [-0.436, +0.436]. V must be in [-0.615, +0.615]. Converts YUV to HSB. Y must be in [0, 1]. U must be in [-0.436, +0.436]. V must be in [-0.615, +0.615]. Converts YUV to CMYK. Y must be in [0, 1]. U must be in [-0.436, +0.436]. V must be in [-0.615, +0.615]. Converts CIEXYZ to RGB structure. Converts CIEXYZ to RGB structure. XYZ to L*a*b* transformation function. Converts CIEXYZ to CIELab structure. Converts CIEXYZ to CIELab structure. Converts CIELab to CIEXYZ. Converts CIELab to CIEXYZ. Converts CIELab to RGB. Converts CIELab to RGB. Structure to define HSB. Gets an empty HSB structure; Gets or sets the hue component. Gets or sets saturation component. Gets or sets the brightness component. Creates an instance of a HSB structure. Hue value. Saturation value. Brightness value. Structure to define HSL. Gets an empty HSL structure; Gets or sets the hue component. Gets or sets saturation component. Gets or sets the luminance component. Creates an instance of a HSL structure. Hue value. Saturation value. Lightness value. Structure to define RGB. Gets an empty RGB structure; Structure to define YUV. Gets an empty YUV structure. Creates an instance of a YUV structure. Color representation with specific to be accurate to human perception of parameters like saturation, brightness. This model is similar to HSB except to taking account different degrees to which each of the primary (RGB) colors affects human perception of the overall brightness of a color Gets or set hue (in range [0...1]) Gets or set saturation (in range [0...1]) Gets or set brightness as it is perceived by human (in range [0...1]) Gets or set alpha channel (opacity) (in range [0...1]) Is hue important? Is hue important? 32bpp with alpha, alpha not premultiplied. Binary format: BB GG RR AA or 0xAARRGGBB, no alpha premultiplication (“unassociated alpha” format). Hex in #AARRGGBB format. Hex in AARRGGBB / RRGGBB / ARGB / RGB / #AARRGGBB / #RRGGBB / #ARGB / #RGB format, or a known color name. Hex in AARRGGBB / RRGGBB / ARGB / RGB / #AARRGGBB / #RRGGBB / #ARGB / #RGB format, or a known color name, or an empty string for NULL value (hence Any). Only hex in AARRGGBB / RRGGBB / ARGB / RGB / #AARRGGBB / #RRGGBB / #ARGB / #RGB format. Hex in RRGGBBAA / RRGGBB / RGBA / RGB / #RRGGBBAA / #RRGGBB / #RGBA / #RGB format. Conversion for the raw binary form where blue goes first (in the lowest bits, as we got low endianness), then green, red, and alpha is in the highest bits: BB GG RR AA. The hexadecimal notation for this layout would be 0xAARRGGBB with highest bits written first. This is the natural memory layout for this color object. Doing an explicit cast operator or reinterpret-cast will yield the same result. Conversion for the raw binary form where blue goes first (in the lowest bits, as we got low endianness), then green, red, and the highest bits which normally define alpha are ignored and substituted for FF: BB GG RR FF. The hexadecimal notation for this layout would be 0xFFRRGGBB with highest bits written first. This is the natural memory layout for this color object. Doing an explicit cast operator or reinterpret-cast will yield the same result. Conversion for the raw binary form where blue goes first (in the lowest bits, as we got low endianness), then green, red, and alpha is in the highest bits: BB GG RR AA. The hexadecimal notation for this layout would be 0xAARRGGBB with highest bits written first. This is the natural memory layout for this color object. Doing an explicit cast operator or reinterpret-cast will yield the same result. Colors - A collection of well-known Colors Well-known color: AliceBlue Well-known color: AntiqueWhite Well-known color: Aqua Well-known color: Aquamarine Well-known color: Azure Well-known color: Beige Well-known color: Bisque Well-known color: Black Well-known color: BlanchedAlmond Well-known color: Blue Well-known color: BlueViolet Well-known color: Brown Well-known color: BurlyWood Well-known color: CadetBlue Well-known color: Chartreuse Well-known color: Chocolate Well-known color: Coral Well-known color: CornflowerBlue Well-known color: Cornsilk Well-known color: Crimson Well-known color: Cyan Well-known color: DarkBlue Well-known color: DarkCyan Well-known color: DarkGoldenrod Well-known color: DarkGray Well-known color: DarkGreen Well-known color: DarkKhaki Well-known color: DarkMagenta Well-known color: DarkOliveGreen Well-known color: DarkOrange Well-known color: DarkOrchid Well-known color: DarkRed Well-known color: DarkSalmon Well-known color: DarkSeaGreen Well-known color: DarkSlateBlue Well-known color: DarkSlateGray Well-known color: DarkTurquoise Well-known color: DarkViolet Well-known color: DeepPink Well-known color: DeepSkyBlue Well-known color: DimGray Well-known color: DodgerBlue Well-known color: Firebrick Well-known color: FloralWhite Well-known color: ForestGreen Well-known color: Fuchsia Well-known color: Gainsboro Well-known color: GhostWhite Well-known color: Gold Well-known color: Goldenrod Well-known color: Gray Well-known color: Green Well-known color: GreenYellow Well-known color: Honeydew Well-known color: HotPink Well-known color: IndianRed Well-known color: Indigo Well-known color: Ivory Well-known color: Khaki Well-known color: Lavender Well-known color: LavenderBlush Well-known color: LawnGreen Well-known color: LemonChiffon Well-known color: LightBlue Well-known color: LightCoral Well-known color: LightCyan Well-known color: LightGoldenrodYellow Well-known color: LightGray Well-known color: LightGreen Well-known color: LightPink Well-known color: LightSalmon Well-known color: LightSeaGreen Well-known color: LightSkyBlue Well-known color: LightSlateGray Well-known color: LightSteelBlue Well-known color: LightYellow Well-known color: Lime Well-known color: LimeGreen Well-known color: Linen Well-known color: Magenta Well-known color: Maroon Well-known color: MediumAquamarine Well-known color: MediumBlue Well-known color: MediumOrchid Well-known color: MediumPurple Well-known color: MediumSeaGreen Well-known color: MediumSlateBlue Well-known color: MediumSpringGreen Well-known color: MediumTurquoise Well-known color: MediumVioletRed Well-known color: MidnightBlue Well-known color: MintCream Well-known color: MistyRose Well-known color: Moccasin Well-known color: NavajoWhite Well-known color: Navy Well-known color: OldLace Well-known color: Olive Well-known color: OliveDrab Well-known color: Orange Well-known color: OrangeRed Well-known color: Orchid Well-known color: PaleGoldenrod Well-known color: PaleGreen Well-known color: PaleTurquoise Well-known color: PaleVioletRed Well-known color: PapayaWhip Well-known color: PeachPuff Well-known color: Peru Well-known color: Pink Well-known color: Plum Well-known color: PowderBlue Well-known color: Purple Well-known color: Red Well-known color: RosyBrown Well-known color: RoyalBlue Well-known color: SaddleBrown Well-known color: Salmon Well-known color: SandyBrown Well-known color: SeaGreen Well-known color: SeaShell Well-known color: Sienna Well-known color: Silver Well-known color: SkyBlue Well-known color: SlateBlue Well-known color: SlateGray Well-known color: Snow Well-known color: SpringGreen Well-known color: SteelBlue Well-known color: Tan Well-known color: Teal Well-known color: Thistle Well-known color: Tomato Well-known color: Transparent Well-known color: Turquoise Well-known color: Violet Well-known color: Wheat Well-known color: White Well-known color: WhiteSmoke Well-known color: Yellow Well-known color: YellowGreen Looks up a known color from by its name. Enum containing handles to all known colors Since the first element is 0, second is 1, etc, we can use this to index directly into an array A 2D transformations matrix. Forked from System.Windows.Media.Matrix. Creates a matrix of the form / m11, m12, 0 \ | m21, m22, 0 | \ offsetX, offsetY, 1 / The determinant of this matrix HasInverse Property - returns true if this matrix is invertable, false otherwise. Identity Tests whether or not a given transform is an identity transform Tests whether or not a given transform is an identity transform or the default value for a transform. M11 M12 M22 M22 OffsetX OffsetY Append - "this" becomes this * matrix, the same as this *= matrix. The JetMatrix to append to this JetMatrix Rotates this matrix about the origin The angle to rotate specified in degrees The centerX of rotation The centerY of rotation Creates a rotation transformation about the given point The angle to rotate specified in radians The centerX of rotation The centerY of rotation Creates a scaling transform around the given point The scale factor in the x dimension The scale factor in the y dimension The centerX of scaling The centerY of scaling Creates a scaling transform around the origin The scale factor in the x dimension The scale factor in the y dimension Creates a skew transform The skew angle in the x dimension in radians The skew angle in the y dimension in radians Sets the transformation to the given translation specified by the offset vector. The offset in X The offset in Y Compares two JetMatrix instances for object equality. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if the two JetMatrix instances are exactly equal, false otherwise The first JetMatrix to compare The second JetMatrix to compare Equals - compares this JetMatrix with the passed in object. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if the object is an instance of JetMatrix and if it's equal to "this". The object to compare to "this" Equals - compares this JetMatrix with the passed in object. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if "value" is equal to "this". The JetMatrix to compare to "this" Returns the HashCode for this JetMatrix int - the HashCode for this JetMatrix Replaces matrix with the inverse of the transformation. This will throw an InvalidOperationException if !HasInverse This will throw an InvalidOperationException if the matrix is non-invertable Multiply Compares two JetMatrix instances for exact equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. Furthermore, using this equality operator, Double.NaN is not equal to itself. bool - true if the two JetMatrix instances are exactly equal, false otherwise The first JetMatrix to compare The second JetMatrix to compare Compares two JetMatrix instances for exact inequality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. Furthermore, using this equality operator, Double.NaN is not equal to itself. bool - true if the two JetMatrix instances are exactly unequal, false otherwise The first JetMatrix to compare The second JetMatrix to compare Multiplies two transformations. Parse - returns an instance converted from the provided string using the culture "en-US" string with JetMatrix data Prepend - "this" becomes matrix * this, the same as this = matrix * this. The JetMatrix to prepend to this JetMatrix Rotates this matrix about the origin The angle to rotate specified in degrees Rotates this matrix about the given point The angle to rotate specified in degrees The centerX of rotation The centerY of rotation Prepends a rotation about the given point to "this" The angle to rotate specified in degrees The centerX of rotation The centerY of rotation Prepends a rotation about the origin to "this" The angle to rotate specified in degrees Scales this matrix around the origin The scale factor in the x dimension The scale factor in the y dimension Scales this matrix around the center provided The scale factor in the x dimension The scale factor in the y dimension The centerX about which to scale The centerY about which to scale Prepends a scale around the center provided to "this" The scale factor in the x dimension The scale factor in the y dimension The centerX about which to scale The centerY about which to scale Prepends a scale around the origin to "this" The scale factor in the x dimension The scale factor in the y dimension Skews this matrix The skew angle in the x dimension in degrees The skew angle in the y dimension in degrees Prepends a skew to this matrix The skew angle in the x dimension in degrees The skew angle in the y dimension in degrees Creates a string representation of this object based on the current culture. A string representation of this object. Creates a string representation of this object based on the IFormatProvider passed in. If the provider is null, the CurrentCulture is used. A string representation of this object. Transform - returns the result of transforming the point by this matrix The transformed point The JetPoint to transform Transform - returns the result of transforming the JetVector by this matrix. The transformed vector The JetVector to transform Translates this matrix The offset in the x dimension The offset in the y dimension Prepends a translation to this matrix The offset in the x dimension The offset in the y dimension Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. Asserts that the matrix tag is one of the valid options and that coefficients are correct. Efficient but conservative test for identity. Returns true if the the matrix is identity. If it returns false the matrix may still be identity. Multiplies two transformations, where the behavior is matrix1 *= matrix2. This code exists so that we can efficient combine matrices without copying the data around, since each matrix is 52 bytes. To reduce duplication and to ensure consistent behavior, this is the method which is used to implement Matrix * Matrix as well. MultiplyPoint MultiplyVector Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. A 2D point in physical (device-specific, hence depending on the resolution of that device, such as display screen) coordinates. Forked from System.Windows.Point. Constructor which accepts the X and Y values The value for the X coordinate of the new JetPhysicalPoint The value for the Y coordinate of the new JetPhysicalPoint X - int. Default value is 0. Y - int. Default value is 0. Add: JetPhysicalPoint + JetPhysicalVector JetPhysicalPoint - The result of the addition The JetPhysicalPoint to be added to the JetPhysicalVector The JetPhysicalVector to be added to the JetPhysicalPoint Compares two JetPhysicalPoint instances for object equality. bool - true if the two JetPhysicalPoint instances are exactly equal, false otherwise The first JetPhysicalPoint to compare The second JetPhysicalPoint to compare Equals - compares this JetPhysicalPoint with the passed in object. bool - true if the object is an instance of JetPhysicalPoint and if it's equal to "this". The object to compare to "this" Equals - compares this JetPhysicalPoint with the passed in object. bool - true if "value" is equal to "this". The JetPhysicalPoint to compare to "this" Returns the HashCode for this JetPhysicalPoint int - the HashCode for this JetPhysicalPoint Offset - update the location by adding offsetX to X and offsetY to Y The offset in the x dimension The offset in the y dimension Operator JetPhysicalPoint + JetPhysicalVector JetPhysicalPoint - The result of the addition The JetPhysicalPoint to be added to the JetPhysicalVector The Vectr to be added to the JetPhysicalPoint Compares two JetPhysicalPoint instances for exact equality. bool - true if the two JetPhysicalPoint instances are exactly equal, false otherwise The first JetPhysicalPoint to compare The second JetPhysicalPoint to compare Explicit conversion to JetPhysicalSize. Note that since JetPhysicalSize cannot contain negative values, the resulting size will contains the absolute values of X and Y JetPhysicalSize - A JetPhysicalSize equal to this JetPhysicalPoint JetPhysicalPoint - the JetPhysicalPoint to convert to a JetPhysicalSize Explicit conversion to JetPhysicalVector JetPhysicalVector - A JetPhysicalVector equal to this JetPhysicalPoint JetPhysicalPoint - the JetPhysicalPoint to convert to a JetPhysicalVector Compares two JetPhysicalPoint instances for exact inequality. bool - true if the two JetPhysicalPoint instances are exactly unequal, false otherwise The first JetPhysicalPoint to compare The second JetPhysicalPoint to compare Operator JetPhysicalPoint - JetPhysicalVector JetPhysicalPoint - The result of the subtraction The JetPhysicalPoint from which the JetPhysicalVector is subtracted The JetPhysicalVector which is subtracted from the JetPhysicalPoint Operator JetPhysicalPoint - JetPhysicalPoint JetPhysicalVector - The result of the subtraction The JetPhysicalPoint from which point2 is subtracted The JetPhysicalPoint subtracted from point1 Parse - returns an instance converted from the provided string using the culture "en-US" string with JetPhysicalPoint data Subtract: JetPhysicalPoint - JetPhysicalVector JetPhysicalPoint - The result of the subtraction The JetPhysicalPoint from which the JetPhysicalVector is subtracted The JetPhysicalVector which is subtracted from the JetPhysicalPoint Subtract: JetPhysicalPoint - JetPhysicalPoint JetPhysicalVector - The result of the subtraction The JetPhysicalPoint from which point2 is subtracted The JetPhysicalPoint subtracted from point1 Creates a string representation of this object based on the current culture. A string representation of this object. Creates a string representation of this object based on the IFormatProvider passed in. If the provider is null, the CurrentCulture is used. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. A 2D rectangle in physical (device-specific, hence depending on the resolution of that device, such as display screen) coordinates. Rects are stored as X, Y (Location) and Width and Height (JetPhysicalSize). As a result, Rects cannot have negative Width or Height. Forked from System.Windows.Rect. Constructor which sets the initial values to the values of the parameters Constructor which sets the initial values to the values of the parameters. Width and Height must be non-negative Constructor which sets the initial values to bound the two points provided. Constructor which sets the initial values to bound the point provided and the point which results from point + vector. Constructor which sets the initial values to bound the (0,0) point and the point that results from (0,0) + size. A special empty rect ctor to bypass checks. Bottom Property - This is a read-only alias for Y + Height If this is the empty rectangle, the value will be negative infinity. BottomLeft Property - This is a read-only alias for the JetPhysicalPoint which is at X, Y + Height If this is the empty rectangle, the value will be positive infinity, negative infinity. BottomRight Property - This is a read-only alias for the JetPhysicalPoint which is at X + Width, Y + Height If this is the empty rectangle, the value will be negative infinity, negative infinity. Empty - a static property which provides an Empty rectangle. X and Y are positive-infinity and Width and Height are negative infinity. This is the only situation where Width or Height can be negative. Height - The Height component of the JetPhysicalSize. This cannot be set to negative, and will only be negative if this is the empty rectangle, in which case it will be negative infinity. If this rect is Empty, setting this property is illegal. IsEmpty - this returns true if this rect is the Empty rectangle. Note: If width or height are 0 this Rectangle still contains a 0 or 1 dimensional set of points, so this method should not be used to check for 0 area. Left Property - This is a read-only alias for X If this is the empty rectangle, the value will be positive infinity. Location - The JetPhysicalPoint representing the origin of the Rectangle Right Property - This is a read-only alias for X + Width If this is the empty rectangle, the value will be negative infinity. JetPhysicalSize - The JetPhysicalSize representing the area of the Rectangle Top Property - This is a read-only alias for Y If this is the empty rectangle, the value will be positive infinity. TopLeft Property - This is a read-only alias for the JetPhysicalPoint which is at X, Y If this is the empty rectangle, the value will be positive infinity, positive infinity. TopRight Property - This is a read-only alias for the JetPhysicalPoint which is at X + Width, Y If this is the empty rectangle, the value will be negative infinity, positive infinity. Width - The Width component of the JetPhysicalSize. This cannot be set to negative, and will only be negative if this is the empty rectangle, in which case it will be negative infinity. If this rect is Empty, setting this property is illegal. X - The X coordinate of the Location. If this is the empty rectangle, the value will be positive infinity. If this rect is Empty, setting this property is illegal. Y - The Y coordinate of the Location If this is the empty rectangle, the value will be positive infinity. If this rect is Empty, setting this property is illegal. Contains - Returns true if the JetPhysicalPoint is within the rectangle, inclusive of the edges. Returns false otherwise. The point which is being tested Returns true if the JetPhysicalPoint is within the rectangle. Returns false otherwise Contains - Returns true if the JetPhysicalPoint represented by x,y is within the rectangle inclusive of the edges. Returns false otherwise. X coordinate of the point which is being tested Y coordinate of the point which is being tested Returns true if the JetPhysicalPoint represented by x,y is within the rectangle. Returns false otherwise. Contains - Returns true if the JetPhysicalRect non-Empty and is entirely contained within the rectangle, inclusive of the edges. Returns false otherwise Compares two JetPhysicalRect instances for object equality. bool - true if the two JetPhysicalRect instances are exactly equal, false otherwise The first JetPhysicalRect to compare The second JetPhysicalRect to compare Equals - compares this JetPhysicalRect with the passed in object. bool - true if the object is an instance of JetPhysicalRect and if it's equal to "this". The object to compare to "this" Equals - compares this JetPhysicalRect with the passed in object. bool - true if "value" is equal to "this". The JetPhysicalRect to compare to "this" Creates a rectangle from four coordinates, swaps them as needed if far is less than near. Returns the HashCode for this JetPhysicalRect int - the HashCode for this JetPhysicalRect Inflate - inflate the bounds by the size provided, in all directions If this is Empty, this method is illegal. Inflate - inflate the bounds by the size provided, in all directions. If -width is > Width / 2 or -height is > Height / 2, this JetPhysicalRect becomes Empty If this is Empty, this method is illegal. Intersect - Update this rectangle to be the intersection of this and rect If either this or rect are Empty, the result is Empty as well. The rect to intersect with this IntersectsWith - Returns true if the JetPhysicalRect intersects with this rectangle Returns false otherwise. Note that if one edge is coincident, this is considered an intersection. Returns true if the JetPhysicalRect intersects with this rectangle Returns false otherwise. or Height JetPhysicalRect Offset - translate the Location by the offset provided. If this is Empty, this method is illegal. Offset - translate the Location by the offset provided If this is Empty, this method is illegal. Compares two JetPhysicalRect instances for exact equality. bool - true if the two JetPhysicalRect instances are exactly equal, false otherwise The first JetPhysicalRect to compare The second JetPhysicalRect to compare Compares two JetPhysicalRect instances for exact inequality. bool - true if the two JetPhysicalRect instances are exactly unequal, false otherwise The first JetPhysicalRect to compare The second JetPhysicalRect to compare Parse - returns an instance converted from the provided string using the culture "en-US" string with JetPhysicalRect data Scale the rectangle in the X and Y directions The scale in X The scale in Y Creates a string representation of this object based on the current culture. A string representation of this object. Creates a string representation of this object based on the IFormatProvider passed in. If the provider is null, the CurrentCulture is used. A string representation of this object. Union - Update this rectangle to be the union of this and rect. Union - Update this rectangle to be the union of this and point. ContainsInternal - Performs just the "point inside" logic bool - true if the point is inside the rect The x-coord of the point to test The y-coord of the point to test Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. A 2D size in physical (device-specific, hence depending on the resolution of that device, such as display screen) coordinates. Defines a size in terms of non-negative width and height. Forked from System.Windows.Size. Constructor which sets the size's initial values. Width and Height must be non-negative int - The initial Width int - THe initial Height Empty - a static property which provides an Empty size. Width and Height are negative-infinity. This is the only situation where size can be negative. Height - Default is 0, must be non-negative. IsEmpty - this returns true if this size is the Empty size. Note: If size is 0 this JetPhysicalSize still contains a 0 or 1 dimensional set of points, so this method should not be used to check for 0 area. Width - Default is 0, must be non-negative Compares two JetPhysicalSize instances for object equality. bool - true if the two JetPhysicalSize instances are exactly equal, false otherwise The first JetPhysicalSize to compare The second JetPhysicalSize to compare Equals - compares this JetPhysicalSize with the passed in object. bool - true if the object is an instance of JetPhysicalSize and if it's equal to "this". The object to compare to "this" Equals - compares this JetPhysicalSize with the passed in object. bool - true if "value" is equal to "this". The JetPhysicalSize to compare to "this" Returns the HashCode for this JetPhysicalSize int - the HashCode for this JetPhysicalSize Operator JetPhysicalSize + JetPhysicalSize Compares two JetPhysicalSize instances for exact equality. bool - true if the two JetPhysicalSize instances are exactly equal, false otherwise The first JetPhysicalSize to compare The second JetPhysicalSize to compare Explicit conversion to JetPhysicalVector. JetPhysicalVector - A JetPhysicalVector equal to this JetPhysicalSize JetPhysicalSize - the JetPhysicalSize to convert to a JetPhysicalVector Explicit conversion to JetPhysicalPoint JetPhysicalPoint - A JetPhysicalPoint equal to this JetPhysicalSize JetPhysicalSize - the JetPhysicalSize to convert to a JetPhysicalPoint Compares two JetPhysicalSize instances for exact inequality. bool - true if the two JetPhysicalSize instances are exactly unequal, false otherwise The first JetPhysicalSize to compare The second JetPhysicalSize to compare Operator JetPhysicalSize - JetPhysicalSize Parse - returns an instance converted from the provided string using the culture "en-US" string with JetPhysicalSize data Creates a string representation of this object based on the current culture. A string representation of this object. Creates a string representation of this object based on the IFormatProvider passed in. If the provider is null, the CurrentCulture is used. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. A 2D thickness/padding in physical (device-specific, hence depending on the resolution of that device, such as display screen) coordinates. JetPhysicalThickness is a value type used to describe the thickness of frame around a rectangle. It contains four ints each corresponding to a side: Left, Top, Right, Bottom. Forked from System.Windows.Thickness. This constructur builds a JetPhysicalThickness with a specified value on every side. The specified uniform length. This constructor builds a JetPhysicalThickness with the specified number of pixels on each side. The thickness for the left side. The thickness for the top side. The thickness for the right side. The thickness for the bottom side. This constructor builds a JetPhysicalThickness with the specified number of pixels on each side. The thickness for the left side and for the right side. The thickness for the top side and for the bottom side. This property is the Length on the thickness' bottom side This property is the Length on the thickness' left side This property is the Length on the thickness' right side This property is the Length on the thickness' top side This function compares to the provided object for type and value equality. Object to compare True if object is a JetPhysicalThickness and all sides of it are equal to this JetPhysicalThickness'. Compares this instance of JetPhysicalThickness with another instance. JetPhysicalThickness instance to compare. trueif this JetPhysicalThickness instance has the same value and unit type as thickness. This function returns a hash code. Hash code Overloaded operator to compare two Thicknesses for equality. first JetPhysicalThickness to compare second JetPhysicalThickness to compare True if all sides of the JetPhysicalThickness are equal, false otherwise Overloaded operator to compare two Thicknesses for inequality. first JetPhysicalThickness to compare second JetPhysicalThickness to compare False if all sides of the JetPhysicalThickness are equal, true otherwise Converts this JetPhysicalThickness object to a string. String conversion. A 2D vector in physical (device-specific, hence depending on the resolution of that device, such as display screen) coordinates. Forked from System.Windows.Vector. Constructor which sets the vector's initial values int - The initial X int - THe initial Y LengthSquared Property - the squared length of this JetPhysicalVector X - int. Default value is 0. Y - int. Default value is 0. Add: JetPhysicalVector + JetPhysicalVector Add: JetPhysicalVector + JetPhysicalPoint CrossProduct - Returns the cross product: vector1.X*vector2.Y - vector1.Y*vector2.X Returns the cross product: vector1.X*vector2.Y - vector1.Y*vector2.X The first JetPhysicalVector The second JetPhysicalVector Determinant - Returns the determinant det(vector1, vector2) Returns the determinant: vector1.X*vector2.Y - vector1.Y*vector2.X The first JetPhysicalVector The second JetPhysicalVector Multiply: JetPhysicalVector / double Compares two JetPhysicalVector instances for object equality. bool - true if the two JetPhysicalVector instances are exactly equal, false otherwise The first JetPhysicalVector to compare The second JetPhysicalVector to compare Equals - compares this JetPhysicalVector with the passed in object. bool - true if the object is an instance of JetPhysicalVector and if it's equal to "this". The object to compare to "this" Equals - compares this JetPhysicalVector with the passed in object. bool - true if "value" is equal to "this". The JetPhysicalVector to compare to "this" Returns the HashCode for this JetPhysicalVector int - the HashCode for this JetPhysicalVector Multiply: JetPhysicalVector * double Multiply: double * JetPhysicalVector Multiply - Returns the dot product: vector1.X*vector2.X + vector1.Y*vector2.Y Returns the dot product: vector1.X*vector2.X + vector1.Y*vector2.Y The first JetPhysicalVector The second JetPhysicalVector Negates the values of X and Y on this JetPhysicalVector Operator JetPhysicalVector + JetPhysicalVector Operator JetPhysicalVector + JetPhysicalPoint Operator JetPhysicalVector / double Compares two JetPhysicalVector instances for exact equality. bool - true if the two JetPhysicalVector instances are exactly equal, false otherwise The first JetPhysicalVector to compare The second JetPhysicalVector to compare Explicit conversion to JetPhysicalSize. Note that since JetPhysicalSize cannot contain negative values, the resulting size will contains the absolute values of X and Y JetPhysicalSize - A JetPhysicalSize equal to this JetPhysicalVector JetPhysicalVector - the JetPhysicalVector to convert to a JetPhysicalSize Explicit conversion to JetPhysicalPoint JetPhysicalPoint - A JetPhysicalPoint equal to this JetPhysicalVector JetPhysicalVector - the JetPhysicalVector to convert to a JetPhysicalPoint Compares two JetPhysicalVector instances for exact inequality. bool - true if the two JetPhysicalVector instances are exactly unequal, false otherwise The first JetPhysicalVector to compare The second JetPhysicalVector to compare Operator JetPhysicalVector * double Operator double * JetPhysicalVector Operator JetPhysicalVector * JetPhysicalVector, interpreted as their dot product Operator JetPhysicalVector - JetPhysicalVector Operator -JetPhysicalVector (unary negation) Parse - returns an instance converted from the provided string using the culture "en-US" string with JetPhysicalVector data Subtract: JetPhysicalVector - JetPhysicalVector Creates a string representation of this object based on the current culture. A string representation of this object. Creates a string representation of this object based on the IFormatProvider passed in. If the provider is null, the CurrentCulture is used. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. A 2D point in logical (device-independent and resolution-independent) coordinates. Forked from System.Windows.Point. Constructor which accepts the X and Y values The value for the X coordinate of the new JetPoint The value for the Y coordinate of the new JetPoint X - double. Default value is 0. Y - double. Default value is 0. Add: JetPoint + JetVector JetPoint - The result of the addition The JetPoint to be added to the JetVector The JetVector to be added to the JetPoint Compares two JetPoint instances for object equality. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if the two JetPoint instances are exactly equal, false otherwise The first JetPoint to compare The second JetPoint to compare Equals - compares this JetPoint with the passed in object. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if the object is an instance of JetPoint and if it's equal to "this". The object to compare to "this" Equals - compares this JetPoint with the passed in object. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if "value" is equal to "this". The JetPoint to compare to "this" Returns the HashCode for this JetPoint int - the HashCode for this JetPoint Multiply: JetPoint * JetMatrix Offset - update the location by adding offsetX to X and offsetY to Y The offset in the x dimension The offset in the y dimension Operator JetPoint + JetVector JetPoint - The result of the addition The JetPoint to be added to the JetVector The Vectr to be added to the JetPoint Compares two JetPoint instances for exact equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. Furthermore, using this equality operator, Double.NaN is not equal to itself. bool - true if the two JetPoint instances are exactly equal, false otherwise The first JetPoint to compare The second JetPoint to compare Explicit conversion to JetSize. Note that since JetSize cannot contain negative values, the resulting size will contains the absolute values of X and Y JetSize - A JetSize equal to this JetPoint JetPoint - the JetPoint to convert to a JetSize Explicit conversion to JetVector JetVector - A JetVector equal to this JetPoint JetPoint - the JetPoint to convert to a JetVector Compares two JetPoint instances for exact inequality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. Furthermore, using this equality operator, Double.NaN is not equal to itself. bool - true if the two JetPoint instances are exactly unequal, false otherwise The first JetPoint to compare The second JetPoint to compare Operator JetPoint * JetMatrix Operator JetPoint - JetVector JetPoint - The result of the subtraction The JetPoint from which the JetVector is subtracted The JetVector which is subtracted from the JetPoint Operator JetPoint - JetPoint JetVector - The result of the subtraction The JetPoint from which point2 is subtracted The JetPoint subtracted from point1 Parse - returns an instance converted from the provided string using the culture "en-US" string with JetPoint data Subtract: JetPoint - JetVector JetPoint - The result of the subtraction The JetPoint from which the JetVector is subtracted The JetVector which is subtracted from the JetPoint Subtract: JetPoint - JetPoint JetVector - The result of the subtraction The JetPoint from which point2 is subtracted The JetPoint subtracted from point1 Creates a string representation of this object based on the current culture. A string representation of this object. Creates a string representation of this object based on the IFormatProvider passed in. If the provider is null, the CurrentCulture is used. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. A 2D rectangle in logical (device-independent and resolution-independent) coordinates. Rects are stored as X, Y (Location) and Width and Height (JetSize). As a result, Rects cannot have negative Width or Height. Forked from System.Windows.Rect. Constructor which sets the initial values to the values of the parameters Constructor which sets the initial values to the values of the parameters. Width and Height must be non-negative Constructor which sets the initial values to bound the two points provided. Constructor which sets the initial values to bound the point provided and the point which results from point + vector. Constructor which sets the initial values to bound the (0,0) point and the point that results from (0,0) + size. A special empty rect ctor to bypass checks. Bottom Property - This is a read-only alias for Y + Height If this is the empty rectangle, the value will be negative infinity. BottomLeft Property - This is a read-only alias for the JetPoint which is at X, Y + Height If this is the empty rectangle, the value will be positive infinity, negative infinity. BottomRight Property - This is a read-only alias for the JetPoint which is at X + Width, Y + Height If this is the empty rectangle, the value will be negative infinity, negative infinity. Empty - a static property which provides an Empty rectangle. X and Y are positive-infinity and Width and Height are negative infinity. This is the only situation where Width or Height can be negative. Height - The Height component of the JetSize. This cannot be set to negative, and will only be negative if this is the empty rectangle, in which case it will be negative infinity. If this rect is Empty, setting this property is illegal. IsEmpty - this returns true if this rect is the Empty rectangle. Note: If width or height are 0 this Rectangle still contains a 0 or 1 dimensional set of points, so this method should not be used to check for 0 area. Left Property - This is a read-only alias for X If this is the empty rectangle, the value will be positive infinity. Location - The JetPoint representing the origin of the Rectangle Right Property - This is a read-only alias for X + Width If this is the empty rectangle, the value will be negative infinity. JetSize - The JetSize representing the area of the Rectangle Top Property - This is a read-only alias for Y If this is the empty rectangle, the value will be positive infinity. TopLeft Property - This is a read-only alias for the JetPoint which is at X, Y If this is the empty rectangle, the value will be positive infinity, positive infinity. TopRight Property - This is a read-only alias for the JetPoint which is at X + Width, Y If this is the empty rectangle, the value will be negative infinity, positive infinity. Width - The Width component of the JetSize. This cannot be set to negative, and will only be negative if this is the empty rectangle, in which case it will be negative infinity. If this rect is Empty, setting this property is illegal. X - The X coordinate of the Location. If this is the empty rectangle, the value will be positive infinity. If this rect is Empty, setting this property is illegal. Y - The Y coordinate of the Location If this is the empty rectangle, the value will be positive infinity. If this rect is Empty, setting this property is illegal. Contains - Returns true if the JetPoint is within the rectangle, inclusive of the edges. Returns false otherwise. The point which is being tested Returns true if the JetPoint is within the rectangle. Returns false otherwise Contains - Returns true if the JetPoint represented by x,y is within the rectangle inclusive of the edges. Returns false otherwise. X coordinate of the point which is being tested Y coordinate of the point which is being tested Returns true if the JetPoint represented by x,y is within the rectangle. Returns false otherwise. Contains - Returns true if the JetRect non-Empty and is entirely contained within the rectangle, inclusive of the edges. Returns false otherwise Compares two JetRect instances for object equality. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if the two JetRect instances are exactly equal, false otherwise The first JetRect to compare The second JetRect to compare Equals - compares this JetRect with the passed in object. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if the object is an instance of JetRect and if it's equal to "this". The object to compare to "this" Equals - compares this JetRect with the passed in object. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if "value" is equal to "this". The JetRect to compare to "this" Creates a rectangle from four coordinates, swaps them as needed if far is less than near. Returns the HashCode for this JetRect int - the HashCode for this JetRect Inflate - inflate the bounds by the size provided, in all directions If this is Empty, this method is illegal. Inflate - inflate the bounds by the size provided, in all directions. If -width is > Width / 2 or -height is > Height / 2, this JetRect becomes Empty If this is Empty, this method is illegal. Intersect - Update this rectangle to be the intersection of this and rect If either this or rect are Empty, the result is Empty as well. The rect to intersect with this IntersectsWith - Returns true if the JetRect intersects with this rectangle Returns false otherwise. Note that if one edge is coincident, this is considered an intersection. Returns true if the JetRect intersects with this rectangle Returns false otherwise. or Height JetRect Offset - translate the Location by the offset provided. If this is Empty, this method is illegal. Offset - translate the Location by the offset provided If this is Empty, this method is illegal. Compares two JetRect instances for exact equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. Furthermore, using this equality operator, Double.NaN is not equal to itself. bool - true if the two JetRect instances are exactly equal, false otherwise The first JetRect to compare The second JetRect to compare Compares two JetRect instances for exact inequality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. Furthermore, using this equality operator, Double.NaN is not equal to itself. bool - true if the two JetRect instances are exactly unequal, false otherwise The first JetRect to compare The second JetRect to compare Parse - returns an instance converted from the provided string using the culture "en-US" string with JetRect data Scale the rectangle in the X and Y directions The scale in X The scale in Y Creates a string representation of this object based on the current culture. A string representation of this object. Creates a string representation of this object based on the IFormatProvider passed in. If the provider is null, the CurrentCulture is used. A string representation of this object. Updates rectangle to be the bounds of the original value transformed by the matrix. The Empty JetRect is not affected by this call. JetMatrix Union - Update this rectangle to be the union of this and rect. Union - Update this rectangle to be the union of this and point. ContainsInternal - Performs just the "point inside" logic bool - true if the point is inside the rect The x-coord of the point to test The y-coord of the point to test Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. A helper class for carrying out advanced operations over rectangles. All docking sides, in LTRB order (except for fill mode, which is NULL with a nullable docking style). Centers one rectangle within another. The rectangle to align. The returned value will have the same size. The bounds to align the within, may be smaller than . Centers one rectangle within another. The size of the rectangle to align. The returned value will have the same size. The bounds to align the within, may be smaller than . Centers one rectangle within another. The rectangle to align. The returned value will have the same size. The bounds to align the within, may be smaller than . Centers one rectangle within another. The size of the rectangle to align. The returned value will have the same size. The bounds to align the within, may be smaller than . Centers one rectangle within another and crops down as needed. The rectangle to align. The returned value may be cropped down by the . The bounds to align the within, may be smaller than . Centers one rectangle within another and crops down as needed. The size of the rectangle to align. The returned value may be cropped down by the . The bounds to align the within, may be smaller than . Centers one rectangle within another and crops down as needed. The rectangle to align. The returned value may be cropped down by the . The bounds to align the within, may be smaller than . Centers one rectangle within another and crops down as needed. The size of the rectangle to align. The returned value may be cropped down by the . The bounds to align the within, may be smaller than . Centers one rectangle within another. If the does not fit into , it's downscaled proportionally. The rectangle to align. The returned value may be downscaled. The bounds to align the within, may be smaller than . Centers one rectangle within another. If the does not fit into , it's downscaled proportionally. The rectangle to align. The returned value may be downscaled. The bounds to align the within, may be smaller than . Centers one rectangle within another. If the does not fit into , it's downscaled proportionally. The size of the rectangle to align. The returned value may be downscaled. The bounds to align the within, may be smaller than . Centers one rectangle within another. If the does not fit into , it's downscaled proportionally. The size of the rectangle to align. The returned value may be downscaled. The bounds to align the within, may be smaller than . Try to make sure one rectangle is located within the other, preferring to keep its size if possible and executing minimal moves. If source rectangle is bigger than the bounds, ensure its left top corner is within the bounds. The rectangle to align. The bounds to align the within, may be smaller than . The rectangle minimal size. Asserts that size dimensions are real numbers. Fluent. Throws on , , . Point to test. Optional. Message to include in the failure exception. Asserts that rectangle coordinates are real numbers. Fluent. Throws on , , . Point to test. Optional. Message to include in the failure exception. Ensures the size is at least . The source size to be limited. May be non-normalized. The limiting minimal size. Must be normalized. The constrainted , guaranteed to be normalized. Ensures the size is at least . The source size to be limited. May be non-normalized. The limiting minimal size. Must be normalized. The constrainted , guaranteed to be normalized. Returns a non-collapsed rectangle attached outside the rectangle. Modifies the rectangle! The attachment anchor. Increased to include the newly-attached rectangle on exit, so that to attach multiple rects in sequence. The docking style, which can be a side-dock only. The characteristic size of the side-attached rectangle (only either width or height, whichever is not defined by the attachment process). The rectangle attached at the given side. Returns a non-collapsed rectangle attached outside the rectangle. Modifies the rectangle! The attachment anchor. Increased to include the newly-attached rectangle on exit, so that to attach multiple rects in sequence. The docking style, which can be a side-dock only. The characteristic size of the side-attached rectangle (only either width or height is used, whichever is not defined by the attachment process). The rectangle attached at the given side. Performs the smart clipping that returns a non-all-zeros rectangle even if there is no intersection. Ie, when the rect lays outside the over some side, the result is a zero-thick projection on that side. Performs the smart clipping that returns a non-all-zeros rectangle even if there is no intersection. Ie, when the rect lays outside the over some side, the result is a zero-thick projection on that side. A helper function for the func, handles one dimension. A helper function for the func, handles one dimension. Collapses a rectangle down to a point. The inside modes are located on the inner sides of the rectangle, and outside ones are one point outside. The bottom-right sides are not included within the rectangle area. Collapses a rectangle down to a point. The inside modes are located on the inner sides of the rectangle, and outside ones are one point outside. The bottom-right sides are not included within the rectangle area. Constrains the size by the . The source size to be limited. May be non-normalized. The limiting size. Must be normalized. The constrainted , guaranteed to be normalized. Constrains the size by the . The source size to be limited. May be non-normalized. The limiting size. Must be normalized. The constrainted , guaranteed to be normalized. Deflates all the rectangle's sides by the given amount. If the numbers are positive, the rectangle will shrink. Deflates all the rectangle's sides by the given amount. If the numbers are positive, the rectangle will shrink. Returns a non-collapsed rectangle docked within the rectangle. Modifies the rectangle! The docking space. Decreased to exclude the newly-docked rectangle on exit, so that to dock multiple rects in sequence. The docking style, which can be either any side or fill. The characteristic size of the side-docked rectangle (either width or height, whichever is not defined by the docking process). In the fill case, this parameter is ignored. The rectangle docked at the given side. Returns a non-collapsed rectangle docked within the rectangle. Modifies the rectangle! The docking space. Decreased to exclude the newly-docked rectangle on exit, so that to dock multiple rects in sequence. The docking style, which can be either any side or fill. The characteristic size of the side-docked rectangle (only either width or height is used, whichever is not defined by the docking process). In the fill case, this parameter is ignored. The rectangle docked at the given side. Returns a non-collapsed rectangle docked within the rectangle. Modifies the rectangle! The docking space. Decreased to exclude the newly-docked rectangle on exit, so that to dock multiple rects in sequence. The docking style, which can be either any side or fill. The corresponding thickness of the side-docked rectangle (only the value corresponding to is used). In the fill case, this parameter is ignored. The rectangle docked at the given side. Returns a non-collapsed rectangle docked within the rectangle. Modifies the rectangle! The docking space. Decreased to exclude the newly-docked rectangle on exit, so that to dock multiple rects in sequence. The docking style, which can be either any side or fill. The characteristic size of the side-docked rectangle (either width or height, whichever is not defined by the docking process). In the fill case, this parameter is ignored. The rectangle docked at the given side. Returns a non-collapsed rectangle docked within the rectangle. Modifies the rectangle! The docking space. Decreased to exclude the newly-docked rectangle on exit, so that to dock multiple rects in sequence. The docking style, which can be either any side or fill. The characteristic size of the side-docked rectangle (only either width or height is used, whichever is not defined by the docking process). In the fill case, this parameter is ignored. The rectangle docked at the given side. Returns a non-collapsed rectangle docked within the rectangle. Modifies the rectangle! The docking space. Decreased to exclude the newly-docked rectangle on exit, so that to dock multiple rects in sequence. The docking style, which can be either any side or fill. The corresponding thickness of the side-docked rectangle (only the value corresponding to is used). In the fill case, this parameter is ignored. The rectangle docked at the given side. Returns a non-collapsed rectangle docked within the rectangle. Does not modify the rectangle. The docking space. The docking style, which can be either any side or fill. The characteristic size of the side-docked rectangle (either width or height, whichever is not defined by the docking process). In the fill case, this parameter is ignored. The rectangle docked at the given side. Returns a non-collapsed rectangle docked within the rectangle. Does not modify the rectangle. The docking space. The docking style, which can be either any side or fill. The characteristic size of the side-docked rectangle (either width or height, whichever is not defined by the docking process). In the fill case, this parameter is ignored. The rectangle docked at the given side. Returns a non-collapsed rectangle docked within the rectangle. Does not modify the rectangle. The docking space. The docking style, which can be either any side or fill. The characteristic size of the side-docked rectangle (only either width or height is used, whichever is not defined by the docking process). In the fill case, this parameter is ignored. The rectangle docked at the given side. Returns a non-collapsed rectangle docked within the rectangle. Does not modify the rectangle. The docking space. The docking style, which can be either any side or fill. The characteristic size of the side-docked rectangle (only either width or height is used, whichever is not defined by the docking process). In the fill case, this parameter is ignored. The rectangle docked at the given side. Returns if the given is "enhanced-empty", that is, either it's , or one of its dimensions is zero. Otherwise, returns the original size. Curcumvents the fact that requires both dimensions to be simultaneousely zero. Returns if the given is "enhanced-empty", that is, either it's , or one of its dimensions is zero. Otherwise, returns the original size. Curcumvents the fact that requires both dimensions to be simultaneousely zero. Creates a rectangle in a way similar to winforms' Rectangle.FromLTRB, but ensures that no dimension is negative. If near is less than far, they're both set to the middle value. Creates a rectangle in a way similar to winforms' Rectangle.FromLTRB, but ensures that no dimension is negative. If near is less than far, they're both set to the middle value. Gets a point that is the center of the rectangle. Gets a point that is the center of the rectangle. Gets a point that is the center of the rectangle. Inflates all the rectangle's sides by the thickness provided, in all directions. Inflates all the rectangle's sides by the thickness provided, in all directions. Gets whether the given rectangle is collapsed, that is, has a zero or negative dimension. Gets whether the given rectangle is collapsed, that is, has a zero or negative dimension. Gets whether the given rectangle is collapsed, that is, has a zero or negative dimension. Gets whether the given rectangle is collapsed, that is, has a zero or negative dimension. Gets whether the given size is collapsed, that is, has a zero or negative dimension. Gets whether the given size is collapsed, that is, has a zero or negative dimension. Gets whether the given rectangle is collapsed, that is, has a zero or negative dimension. Gets whether any of the coordinates are NAN or INF (). Gets whether any of the coordinates are NAN or INF (). Gets whether any of the coordinates are NAN or INF (). Checks whether the rectangle is normalized. A normalized rectangle is such whose left coordinate is not greater than right, and top coordinate is not greater than bottom. Checks whether the size corresponds to a normalized rectangle. A normalized rectangle is such whose left coordinate is not greater than right, and top coordinate is not greater than bottom. Checks whether the size corresponds to a normalized rectangle. A normalized rectangle is such whose left coordinate is not greater than right, and top coordinate is not greater than bottom. Checks whether the rectangle is normalized. A normalized rectangle is such whose left coordinate is not greater than right, and top coordinate is not greater than bottom. Gets the normalized maximum of two sizes, max operation executed independently against both dimensions. 8 Gets the normalized maximum of two sizes, max operation executed independently against both dimensions. Gets the normalized minimum of two sizes, min operation executed independently against both dimensions. Gets the normalized minimum of two sizes, min operation executed independently against both dimensions. Normalizes the rectangle so that it has non-negative and , and passes the with True. Normalizes the rectangle so that it has non-negative and , and passes the with True. Normalizes the size so that it has non-negative and , and passes the with True. Normalizes the size so that it has non-negative and , and passes the with True. Creates a new object that is guaranteed to be normalized and, if at least one of its sides is zero, to be all-zero. The desired width. The desired height. A normalized size whose sides can only simultaneousely be 0. Creates a new object that is guaranteed to be normalized and, if at least one of its sides is zero, to be all-zero. The desired width. The desired height. A normalized size whose sides can only simultaneousely be 0. Creates a new object that is guaranteed to be normalized and, if at least one of its sides is empty, to be . The desired width. The desired height. A normalized size whose sides can only simultaneousely be 0. Stacks a number of sizes horizontally and returns the resulting size. If a size in the list is collapsed, it's not included and the gaps for it are not added. The list of sizes to stack. The gap to insert between the adjacent stack-items. The bounding rect of the result. Stacks a number of sizes horizontally and returns the resulting size. If a size in the list is collapsed, it's not included and the gaps for it are not added. The list of sizes to stack. The gap to insert between the adjacent stack-items. The bounding rect of the result. Stacks a number of sizes vertically and returns the resulting size. If a size in the list is collapsed, it's not included and the gaps for it are not added. The list of sizes to stack. The gap to insert between the adjacent stack-items. The bounding rect of the result. Stacks a number of sizes vertically and returns the resulting size. If a size in the list is collapsed, it's not included and the gaps for it are not added. The list of sizes to stack. The gap to insert between the adjacent stack-items. The bounding rect of the result. Unites the horizontal coordinates of the rectangles, and takes the y-coordinates solely from . The first rectangle, features the y-coordinates of the retval. The second rectangle. Unites the horizontal coordinates of the rectangles, and takes the y-coordinates solely from . The first rectangle, features the y-coordinates of the retval. The second rectangle. Unites the vertical coordinates of the rectangles, and takes the x-coordinates solely from . The first rectangle, features the x-coordinates of the retval. The second rectangle. Unites the vertical coordinates of the rectangles, and takes the x-coordinates solely from . The first rectangle, features the x-coordinates of the retval. The second rectangle. Moves one edge of the rectangle without moving any of the other edges. Moves one edge of the rectangle without moving any of the other edges. Changes the height of the rectangle, not affecting its location. Changes the height of the rectangle, not affecting its location. Moves one edge of the rectangle without moving any of the other edges. Moves one edge of the rectangle without moving any of the other edges. Moves one edge of the rectangle without moving any of the other edges. Moves one edge of the rectangle without moving any of the other edges. Moves one edge of the rectangle without moving any of the other edges. Moves one edge of the rectangle without moving any of the other edges. Changes the width of the rectangle, not affecting its location. Changes the width of the rectangle, not affecting its location. Changes the x-coordinate of the rectangle location, not affecting its dimensions. Changes the x-coordinate of the rectangle location, not affecting its dimensions. Changes the y-coordinate of the rectangle location, not affecting its dimensions. Changes the y-coordinate of the rectangle location, not affecting its dimensions. Turns a double length into an int, coercing NaN and Inf values. Turns a double length into an int, coercing NaN and Inf values. Turns a double length into an int, coercing NaN and Inf values. Turns an int length into an Avalon double length, converting max-int to corresponding infinities. Implements the size-stacking. Implements the size-stacking. A 2D size in logical (device-independent and resolution-independent) coordinates. Defines a size in terms of non-negative width and height. Forked from System.Windows.Size. Constructor which sets the size's initial values. Width and Height must be non-negative double - The initial Width double - THe initial Height Empty - a static property which provides an Empty size. Width and Height are negative-infinity. This is the only situation where size can be negative. Height - Default is 0, must be non-negative. IsEmpty - this returns true if this size is the Empty size. Note: If size is 0 this JetSize still contains a 0 or 1 dimensional set of points, so this method should not be used to check for 0 area. Width - Default is 0, must be non-negative Compares two JetSize instances for object equality. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if the two JetSize instances are exactly equal, false otherwise The first JetSize to compare The second JetSize to compare Equals - compares this JetSize with the passed in object. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if the object is an instance of JetSize and if it's equal to "this". The object to compare to "this" Equals - compares this JetSize with the passed in object. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if "value" is equal to "this". The JetSize to compare to "this" Returns the HashCode for this JetSize int - the HashCode for this JetSize Operator JetSize + JetSize Compares two JetSize instances for exact equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. Furthermore, using this equality operator, Double.NaN is not equal to itself. bool - true if the two JetSize instances are exactly equal, false otherwise The first JetSize to compare The second JetSize to compare Explicit conversion to JetVector. JetVector - A JetVector equal to this JetSize JetSize - the JetSize to convert to a JetVector Explicit conversion to JetPoint JetPoint - A JetPoint equal to this JetSize JetSize - the JetSize to convert to a JetPoint Compares two JetSize instances for exact inequality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. Furthermore, using this equality operator, Double.NaN is not equal to itself. bool - true if the two JetSize instances are exactly unequal, false otherwise The first JetSize to compare The second JetSize to compare Operator JetSize + JetSize Parse - returns an instance converted from the provided string using the culture "en-US" string with JetSize data Creates a string representation of this object based on the current culture. A string representation of this object. Creates a string representation of this object based on the IFormatProvider passed in. If the provider is null, the CurrentCulture is used. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. A 2D thickness/padding in logical (device-independent and resolution-independent) coordinates. JetThickness is a value type used to describe the thickness of frame around a rectangle. It contains four doubles each corresponding to a side: Left, Top, Right, Bottom. Forked from System.Windows.Thickness. This constructur builds a JetThickness with a specified value on every side. The specified uniform length. This constructor builds a JetPhysicalThickness with the specified number of pixels on each side. The thickness for the left side and for the right side. The thickness for the top side and for the bottom side. This constructor builds a JetThickness with the specified number of pixels on each side. The thickness for the left side. The thickness for the top side. The thickness for the right side. The thickness for the bottom side. This property is the Length on the thickness' bottom side This property is the Length on the thickness' left side This property is the Length on the thickness' right side This property is the Length on the thickness' top side This function compares to the provided object for type and value equality. Object to compare True if object is a JetThickness and all sides of it are equal to this JetThickness'. Compares this instance of JetThickness with another instance. JetThickness instance to compare. trueif this JetThickness instance has the same value and unit type as thickness. This function returns a hash code. Hash code Overloaded operator to compare two Thicknesses for equality. first JetThickness to compare second JetThickness to compare True if all sides of the JetThickness are equal, false otherwise Overloaded operator to compare two Thicknesses for inequality. first JetThickness to compare second JetThickness to compare False if all sides of the JetThickness are equal, true otherwise Converts this JetThickness object to a string. String conversion. Compares two thicknesses for fuzzy equality. This function helps compensate for the fact that double values can acquire error when operated upon The first thickness to compare The second thickness to compare Whether or not the two thicknesses are equal Compares two thicknesses for fuzzy equality. This function helps compensate for the fact that double values can acquire error when operated upon The thickness to compare to this Whether or not the two points are equal Verifies if this JetThickness contains only valid values The set of validity checks is passed as parameters. allows negative values allows Double.NaN allows Double.PositiveInfinity allows Double.NegativeInfinity Whether or not the thickness complies to the range specified A 2D vector in logical (device-independent and resolution-independent) coordinates. Forked from System.Windows.Vector. Constructor which sets the vector's initial values double - The initial X double - THe initial Y Length Property - the length of this JetVector LengthSquared Property - the squared length of this JetVector X - double. Default value is 0. Y - double. Default value is 0. Add: JetVector + JetVector Add: JetVector + JetPoint AngleBetween - the angle between 2 vectors Returns the the angle in degrees between vector1 and vector2 The first JetVector The second JetVector CrossProduct - Returns the cross product: vector1.X*vector2.Y - vector1.Y*vector2.X Returns the cross product: vector1.X*vector2.Y - vector1.Y*vector2.X The first JetVector The second JetVector Determinant - Returns the determinant det(vector1, vector2) Returns the determinant: vector1.X*vector2.Y - vector1.Y*vector2.X The first JetVector The second JetVector Multiply: JetVector / double Compares two JetVector instances for object equality. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if the two JetVector instances are exactly equal, false otherwise The first JetVector to compare The second JetVector to compare Equals - compares this JetVector with the passed in object. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if the object is an instance of JetVector and if it's equal to "this". The object to compare to "this" Equals - compares this JetVector with the passed in object. In this equality Double.NaN is equal to itself, unlike in numeric equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. bool - true if "value" is equal to "this". The JetVector to compare to "this" Returns the HashCode for this JetVector int - the HashCode for this JetVector Multiply: JetVector * double Multiply: double * JetVector Multiply: JetVector * JetMatrix Multiply - Returns the dot product: vector1.X*vector2.X + vector1.Y*vector2.Y Returns the dot product: vector1.X*vector2.X + vector1.Y*vector2.Y The first JetVector The second JetVector Negates the values of X and Y on this JetVector Normalize - Updates this JetVector to maintain its direction, but to have a length of 1. This is equivalent to dividing this JetVector by Length Operator JetVector + JetVector Operator JetVector + JetPoint Operator JetVector / double Compares two JetVector instances for exact equality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. Furthermore, using this equality operator, Double.NaN is not equal to itself. bool - true if the two JetVector instances are exactly equal, false otherwise The first JetVector to compare The second JetVector to compare Explicit conversion to JetSize. Note that since JetSize cannot contain negative values, the resulting size will contains the absolute values of X and Y JetSize - A JetSize equal to this JetVector JetVector - the JetVector to convert to a JetSize Explicit conversion to JetPoint JetPoint - A JetPoint equal to this JetVector JetVector - the JetVector to convert to a JetPoint Compares two JetVector instances for exact inequality. Note that double values can acquire error when operated upon, such that an exact comparison between two values which are logically equal may fail. Furthermore, using this equality operator, Double.NaN is not equal to itself. bool - true if the two JetVector instances are exactly unequal, false otherwise The first JetVector to compare The second JetVector to compare Operator JetVector * double Operator double * JetVector Operator JetVector * JetMatrix Operator JetVector * JetVector, interpreted as their dot product Operator JetVector - JetVector Operator -JetVector (unary negation) Parse - returns an instance converted from the provided string using the culture "en-US" string with JetVector data Subtract: JetVector - JetVector Creates a string representation of this object based on the current culture. A string representation of this object. Creates a string representation of this object based on the IFormatProvider passed in. If the provider is null, the CurrentCulture is used. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. Creates a string representation of this object based on the format string and IFormatProvider passed in. If the provider is null, the CurrentCulture is used. See the documentation for IFormattable for more information. A string representation of this object. Coordinates interop with WinAPI. This is build-safe because even though it's not applicable to all OSes, all of the types here are our own and are fully functional (as data types) on any OS. Parses the themed-icons-supported subset of the SVG format into the themed icons image. A fallback brush returned when we fail to parse the fill resource. Not transparent to avoid losing the object shape and make smth visible still. Gets the brush from a resource defined earlier in the parse context. See for params doc. Handles common shape properties, when segments are already obtained by the means of the shape-specific parser. Makes the fill for a path (which is a list of segments). Combined properties from XML properties on the element and style setters from the style property on the element. The parse context, to read pre-declared fill resources (seems the only way to declare gradients). The path segments being painted. As Ti gradients are stored in object coord space, any gradients declared in world coord space must be transformed, and the path bbox gives the transform. If a shape has a transform, these are assumed to be already transformed to it. If the shape itself has a transform, the gradient appears as if applied before the object is transformed (even if in world coordinates). Ti stores the object transform pre-applied: there's no transform, but the path points are written transformed. So this is required to calculate the gradient coords in the transformed object space as if it's being applied to the object before the transform. If the shape has a transform prop/style, reads and parses its value. Otherwise (or if failed), returns the identity transform. Gets attr as a string. Handles two issues: 1) SVG might have hyphens, C# cannot have them — translate from underscores. 2) Enum member ToString is slow when called often. Previously, were creating resources here. Now, as SVG allows forward-references to resources on any level, we collect resources separately beforehand. This method now (a) lets thru resource def elements to not repoer them as unknown/unsupported; (b) marks the spots for parsing resources, should we want to do that again. Reads the fill rule from the shape; returns the updated segments. Values are NOT in pixels by default, so cannot drop the suffix. Negative to match the legacy default. Values are fractions, so percent are OK. The value, taking unit scaling into account (like, percent is /100). Zero if not defined or problems parsing. The value, taking unit scaling into account (like, percent is /100). NULL if not defined or problems parsing. Factor from unit conversion (percent into value). Where it comes from. Can create this from a UNLL property, because many of the stuff is optional. Just as parsed (after stripping units). NULL if not defined or not parsed. Prop value AS IS, if got prop. Units detected and stripped from value, means there were just a number and no units. Should not throw, creates even from a NULL property (no error), reports on parse errors. Asserts on expected units, all parsing errors get into the parsing-time and not into this one. Asserts on expected units, all parsing errors get into the parsing-time and not into this one. Takes a transform of some item in the context, augments it with transforms accumulated in the context. Looks up a resource in this or parent contexts. Child elements. Resource element type. Properties of the resource. A cross-platform wrapper for a raster image which could be loaded into a WPF BitmapSource or its GDI+/Avalonia/Skia counterparts. A cross-platform wrapper for a raster image which could be loaded into a WPF BitmapSource or its GDI+/Avalonia/Skia counterparts. Represents a set of device-dependent raster images. This is supposed to be the same image but for different resolutions (possibly, with different detail level). The images, sorted by resolution, ascending. We expect to have PNG-encoded raster images here. Looks up an image with the closest resoluion. When you have an image for normal resolution and for double resolution in ResX resources of type declaration-side, which makes in code. When you have an image for normal resolution and for double resolution in immutable streams. Looks up an image from the list for this exact resolution. NULL if none. Does not look up nearest or resample. Converts the arc representation from a path arc into the ellipse-centric arc. Based on the SVG 1.1 (Second Edition) standard — Appendix F: Implementation Requirements — F.6 Elliptical arc implementation notes — F.6.5 Conversion from endpoint to center parameterization, https://www.w3.org/TR/SVG/implnote.html#ArcConversionEndpointToCenter . Does NOT handle the out-of-range cases correctly, as customary for SVG processing. Approximates an arc with a number of curves, small enough for the approximation to be decent. See for details. The returned curves are contiguous, i.e. the next start point is the prev end point, and also smooth. If a cubic curve were made by elevating degree of a quadratic (or just happens to match), converts it back. Otherwise, a NULL. Makes Bézier curves for the corners of a rectangle with rounded corners. They're ordered to go one after another, so just connect with straight lines to get a rounded rect path. Converts an arc to a Bézier curve, only if it's small enough to be suitably represented by a curve (here this means a quarter circle at most). The curve is chosen to match the coordinates in the starting and ending points of the arc, their first derivative, and their second derivative. Based on the https://www.spaceroots.org/documents/ellipse/elliptical-arc.pdf article. Resources, like gradients: gets listed in resource map under this ID. Other elements, like graphics or groups: potentially allows tricks with them, but useless for our needs, just ignore; Sketch would plant them all around. Deprecated. Can appear on any element, but has effect only on svg and g as of which we are interested in. On shapes, should have no effect, but we'd sometimes see it on AI exports. The docs are complicated, probably should affect some advanced compositing, like access to intermediate render results from the elements renderers. This is actually an attribute in the namespace, , but we must be listing it together with other attributes as well. Adobe Illustrator tends to set this (illegaly) on shapes sometimes, together with a pretty legal . We'll just let it be, but ignore the value. Encountered in XD exports, randomly added to seemingly anything (especially root and graphics). Some AI exports set this instead of opacity, maybe based on how the fill were defined. We do not support stroke intentionally, by design all stroke-like painting should be done with paths. The original motivation was that there're many peculiarities around painting strokes, caps, miters and all, even within renderers of the same format (say, SVG), and we're trying to render even across formats, into WPF. So the safe version is to render with paths, which produce a fully defined outline, which is pretty compatible across all formats. We still support specifying some stroke properties because they'd be encountered in Sketch exports of certain formats/methods though, but assert they're trivial. This is actually CSS not SVG, but might be encountered in SVG styles. This affects stacking contexts (like, manual z-ordering), which isn't very applicable to us, and prevents blending (multiply, etc) if it's nonstandard, which we do not support anyway. So we can safely ignore “auto” or “isolate” or whatever values here, I believe they cannot affect anything much. SVG attributes in the namespace. Default. Default. SVG Path commands have certain implicit conventions which change the command to another one based on its context. 1) A set of MoveTo commands at the beginning of a figure becomes a set of (one MoveTo command plus LineTo commands). 2) A leading MoveTo-Relative in the path is changed to Absolute, but its following MoveTo-autochanged-into-LineTo remain Relative (that's why it's allowed to write it relative). Path Data attributed tree items. Standard placeholder icons for use in case we cannot load the real icon image. As it's used when there're problems with loading icons, they're emitted in code instead of loading from resources. Gets the default placeholder image to be used in place of images yet to be drawn. Checks equality on image contents, allows for some difference due to rounding or roundtripping doubles when reading and writing. General conversions for the format to and from the popular formats. Special cases are handled by other classes, like export to C# (ThemedIconsCsEmitter) or import from SVG (SvgThemedIconsTransferFormatParser), as it's a complicated lossy import process). The conversions presented here are usually simple and lossless — provided that Avalon vector images comply with what's allowed for a TiIcon. Deserializes a written as a Canonical S-Expression bytestream. Deserializes a written as a Canonical S-Expression bytestream. Deserializes a written as a Canonical S-Expression bytestream which fits in 7 bits, reinterpreted as ASCII into a string. Deserializes a serialized into TiSvg, which is a valid SVG file representing the icon, but using an unflexible subset and formatting of SVG so that it were mapped into TiImage and WPF one-to-one with mere deserialization and no advanced operations. Emits a Scalable Vector Graphics image XML document for the given TiImage, be it vector or raster. The document string is written in such a way that it roundtrips back into a TiImage with , yet it's a valid SVG document which renders the same image. Helper for "TiImageConverter" to handle exporting to the Scalable Vector Graphics format. TiSvg serializer implementation, reader part. Works by strictly matching plain text (no XML reader). Reads #RRGGBB in uppercase hex, always two digits per color. Alpha expected to be stored separately. TiSvg serializer implementation, writer part. Works by emitting a strict-format plain text (no XML writer). Base class for the platform-independent Themed Icon Image. Represents a narrow subset of a XAML DrawimgImage or a raster bitmap which can be rendered on any platform. "TiImageConverter" Gets the device-independent size of the vector image in logical pixels (assuming 96 DPI, like in Avalon). The coordinate space of the image must be aligned at the (0,0) point. The coordinates of the at-1 gradient stop, in boundbox-relatve coords. The coordinates of the at-0 gradient stop, in boundbox-relatve coords. A filled path figure. Based on a path geometry, which is a list of segments. Represents a radial gradient brush, in element-relative coordinates, where (0,0) is the left-top point of the bounding box, and (1,1) is the bottom right. A radial gradient has a starting point (0% gradient stop) from which it goes to the ending ellipse (100% gradient stop). It is not sufficient to specify the ellipse because it might also be skewed and rotated, which can't be expressed with just the ellipse axes. So we would assume the initial ellipse as a circle at (0,0) with radius 1, onto which a transform is applied to achieve the resulting ellipse. The starting point is expressed in the coordinate space in which the ellipse is a unit circle, i.e. the ellipse transform also applies to the starting point. The starting point of the gradient, before the transform is applied, in boundbox-relative coords. The transform which would make the (0,0),1 circle the desired end-ellipse in the element-bounding-box-relative coordinates. The number of pixel lines in the bitmap. The number of pixels in each line. The resolution, which defines the logical size of the bitmap. Bitmap pixels, 32bpp with alpha, alpha not premultiplied. Pixel layout: lines top-down, pixels left-right inside each line, stride equal to line byte length. Pixel format: 0xAARRGGBB, no alpha premultiplication (“unassociated alpha” format). A segment in the path. Target point. For BeginFigure, the starting point of the figure. For Bézier, first control point. For BeginFigure, X tells whether the fill rule is nonzero rather than even-odd, and Y tells whether the figure is closed. For Bézier, second control point X. Calculates the bounding box for the path, incl protruding parts of the curves. Applies a transform to the segments of a path. The representation of the path (points, lines, and Bézier curves in absolute coordinates) ensures that merely applying the matrix to the points transforms the segments correctly. Means we're beginning a new figure, moving to the startpoint (), and defining whether the figure will have a closed path. . is a conditon on the fill rule for this path, 0 means EvenOdd fill rule (default) and anything outside epsilon means Nonzero fill rule. . is a condition on whether the path is closed. A line from the current point and to the , in absolute coordinates. A cubic Bézier curve from the current point and to the , with and as parameters (at curve start and curve target, respectively). A small subset of the XAML vector drawing capabilities. Represents some features of either GeometryDrawing or Path, those of them relevant for iconing and supported cross-platform. All the types and coordinates and measures map directly into the GeometryDrawing entities. Gets the device-independent size of the vector image in logical pixels (assuming 96 DPI, like in Avalon). The coordinate space of the image must be aligned at the (0,0) point. Filled path figures of this vector image. A collection of objects to be checked for a memory leak. An utility to monitor memory leaks. The class made static to be able to survive R# suspend/resume. Let objects to be garbage collected in the "natural" way. Force GC to collect the objects. Get a memory grave for the specified lifetime. Register the object with the leak watchdog. Objects with the same lifetime will be placed in one memory grave. Immediate starts to wait for the object to be collected. Wait for objects to be collected in the specified amount of full GC. There is no timeout, because GC is non-deterministic. In most cases 3 full GC is enough to collect an object. Wait for objects to be collected for the specified timeout. The amount of actual physical memory, in bytes. The amount of physical memory currently available, in bytes. This is the amount of physical memory that can be immediately reused without having to write its contents to disk first. It is the sum of the size of the standby and free. The memory mapped files aren't standby (and not included into PhysicalAvailable amount) while process holds opened handles. The current committed memory limit for the current process. Roughly, it is a sum of physical total and current page file size. The maximum amount of memory the current process can commit, in bytes. Roughly, it is a sum of physical available and page file available amount. BE AWARE: On Windows in some cases SwappableAvailable a bit less than PhysicalAvailable (have no idea why). Shows a system Message Box. Supplies it automatically with icons, main window ownership, and product name in the title. Note: you should be using this class wherever possible instead of the system one, as it provides for consistent look. Shows a message box, owned by the specific window. Handle to the message box owner window, or Null to use the main window of the current application, if available. Body text. Optional message box caption, an empty string to use the product name by default. Otherwise, the product name will be prepended to the provided caption text. The buttons, icons, default button, behavior and so on. Shows a message box with an error message. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Shows a message box with an error message. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Not recommended. Owner window for the message box. Use only in dialogs when the default (app main window) could be inappropriate. Shows a message box with an exclamation message. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Shows a message box with an exclamation message. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Not recommended. Owner window for the message box. Use only in dialogs when the default (app main window) could be inappropriate. Shows a message box with an information message. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Shows a message box with an information message. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Not recommended. Owner window for the message box. Use only in dialogs when the default (app main window) could be inappropriate. Shows a message box, owned by the main window. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Not recommended. Owner window for the message box. Use only in dialogs when the default (app main window) could be inappropriate. Buttons to use. Icon to use. Shows a message box, owned by the main window. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Buttons to use. Icon to use. Shows a message box, owned by the main window. Product name is used for the title. Message body text. Buttons to use. Icon to use. Shows a OK/Cancel question message box. Returns whether the answer was Yes. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Shows a Yes/Cancel question message box. Returns whether the answer was Yes. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Not recommended. Owner window for the message box. Use only in dialogs when the default (app main window) could be inappropriate. Shows a OK/Cancel question message box. Returns whether the answer was Yes. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Not recommended. Owner window for the message box. Use only in dialogs when the default (app main window) could be inappropriate. true - OK button selected by default, false - Cancel > Shows a Yes/No question message box. Returns whether the answer was Yes. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Flag that determines whether message box should be shown on top of other windows or not Shows a Yes/No question message box. Returns whether the answer was Yes. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Not recommended. Owner window for the message box. Use only in dialogs when the default (app main window) could be inappropriate. Flag that determines whether message box should be shown on top of other windows or not Shows a Yes/No question message box. Returns whether the answer was Yes. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Not recommended. Owner window for the message box. Use only in dialogs when the default (app main window) could be inappropriate. true - YES button selected by default, false - NO Flag that determines whether message box should be shown on top of other windows or not > Shows a Yes/No/Cancel question message box. Returns whether the answer was Yes or No, Null for Cancel. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Shows a Yes/No/Cancel question message box. Returns whether the answer was Yes or No, Null for Cancel. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Not recommended. Owner window for the message box. Use only in dialogs when the default (app main window) could be inappropriate. Shows a Yes/No/Cancel question message box. Returns whether the answer was Yes or No, Null for Cancel. Message body text. Not recommended. Text to append to the default caption, which is the product name. In most cases, keep empty to have just the product name. Not recommended. Owner window for the message box. Use only in dialogs when the default (app main window) could be inappropriate. true - YES button selected by default, false - NO, null - CANCEL Gets the stack of the message box handlers, the last one is executed when a message box is attempted to be shown. A handler has the same prototype as , but returns Null if it does not want to handle the message. By default, the message is displayed in a system message box. Free-threaded access. Modifies , see there for comments. Default implementation. Displays the system MessageBox, cannot provide main window ownership and product name. Default implementation. Displays the system MessageBox, cannot provide main window ownership and product name. An exception which gets reported via when a silent error message box tries to show. Msgbox handler prototype. Handle to the message box owner window, or Null to use the main window of the current application, if available. Body text. Optional message box caption, an empty string to use the product name by default. Otherwise, the product name will be prepended to the provided caption text. The buttons, icons, default button, behavior and so on. NULL if not handled, or the pressed button code otherwise. Suppresses message boxes in tests. A delegate instance class for the WinNT message box. Even tho it has no instance members, it's required to give the delegate unique per-instance equality for safe multiple adds/removes in the list. Default implementation. Displays the system MessageBox, cannot provide main window ownership and product name. Event that can be used for cross-process synchronization Reads packs of bytes from the stream, exactly as they were The active read buffer. The only buffer for single-chunk messages (that fit under buffer size). Each chunk in order for multi-chunk messages. Inits. The stream to read messages from. As we've read a chunk of bytes from the stream, tells if this chunk represents a complete message (otherwise, the next chunk[s] should be appended to compose the complete message). For example, on a , this is , which is available on its , but somehow not exposed to the general public. Default size of the buffer. There's a new pack of bytes. Fires for each received pack. Initiates async reading. Reads packs of bytes from a pipe async. Wraps , but adds a wait for the pipe to be connected before actually starting any reads. There's a new pack of bytes. Fires for each received pack. Initiates async reading. Deserializes objects from a pipe working in the message mode. Extends by adding a deserializer. There's a new object. Fires for each received object. Initiates async reading. Returned when you create the reader end of the channel. Gets the channel name, as created by the reader, to be given to the writer side. Enforces waiting for all pending messages to be processed before closing the channel — you must be sure that the writer has disconnected in such case, otherwise you might be waiting indefinitely. Terminating the reader lifetime aborts reading and cancels remaining messages in case you want to break the channel no matter what happens to the other end. If you terminate the other end and want to make sure that all pending messages are read, call this method before proceeding with lifetime termination. Enforces waiting for all pending messages to be processed before closing the channel — you must be sure that the writer has disconnected in such case, otherwise you might be waiting indefinitely. Terminating the reader lifetime aborts reading and cancels remaining messages in case you want to break the channel no matter what happens to the other end. If you terminate the other end and want to make sure that all pending messages are read, call this method before proceeding with lifetime termination. Returned when you create the writer end of the channel. Call to send the next item over the channel. Note that the item could be stored for some time before it is processed for serialization and transmission, so do not modify this object. Writer lifetime must not be terminated when you call this method. Turns item into bytes for sending. This might happen on the sender thread, not when the item is request for sending. That's why you write items in the API, not bytes, and we need a separate functor for turning items into bytes. The item to serialize. In: the buffer for writing, content undefined. If too small, allocate a new one. Out: the buffer stuff has been actually written into, might be the input one. This buffer would be reused when returned, do not treat it as owned or readonly. Out: number of bytes in the buffer for the serialized item. If pipes are not working and is not possible Common interface for and its fallbacks. Defines the channel name, opens the reader, returns the token which allows to enforce waiting for all pending messages to be processed before closing the channel — you must be sure that the writer has disconnected in such case, otherwise you might be waiting indefinitely. Closes the channel and drops unread messages. Callback on every message. The buffer is reusable, do not store it. The token which allows to enforce waiting for all pending messages to be processed before closing the channel — you must be sure that the writer has disconnected in such case, otherwise you might be waiting indefinitely; and the channel name to be passed to the writer. Opens the writing end of the pipe; it's the client, so the server (reader) end must be opened already. Item type, for the serializer. Serialization is taken out async, so the implementation needs the serializer to run. Enforces writing out all remaining items and close the channel. The channel name given in the struct obtained when opening the reader end. Per-item serializer. A token which has the write function. Pumps messages over a pipe between appdomains or processes. Use the instance. Defines the channel name, opens the reader, returns the token which allows to enforce waiting for all pending messages to be processed before closing the channel — you must be sure that the writer has disconnected in such case, otherwise you might be waiting indefinitely. Closes the channel and drops unread messages. Callback on every message. The buffer is reusable, do not store it. The token which allows to enforce waiting for all pending messages to be processed before closing the channel — you must be sure that the writer has disconnected in such case, otherwise you might be waiting indefinitely; and the channel name to be passed to the writer. Opens the writing end of the pipe; it's the client, so the server (reader) end must be opened already. Item type, for the serializer. Serialization is taken out async, so the implementation needs the serializer to run. Enforces writing out all remaining items and close the channel. The channel name given in the struct obtained when opening the reader end. Per-item serializer. A token which has the write function. An async wait handle which is somewhat like the manual-reset wait handle. Resets the state. Awaits for someone to call . Sets the event in the signaled state. Whoever is waiting on , would wake up. Pumps messages over a pipe between appdomains or processes. Use the instance. Defines the channel name, opens the reader, returns the token which allows to enforce waiting for all pending messages to be processed before closing the channel — you must be sure that the writer has disconnected in such case, otherwise you might be waiting indefinitely. Closes the channel and drops unread messages. Callback on every message. The buffer is reusable, do not store it. The token which allows to enforce waiting for all pending messages to be processed before closing the channel — you must be sure that the writer has disconnected in such case, otherwise you might be waiting indefinitely; and the channel name to be passed to the writer. Opens the writing end of the pipe; it's the client, so the server (reader) end must be opened already. Item type, for the serializer. Serialization is taken out async, so the implementation needs the serializer to run. Enforces writing out all remaining items and close the channel. The channel name given in the struct obtained when opening the reader end. Per-item serializer. A token which has the write function. An async wait handle which is somewhat like the manual-reset wait handle. Resets the state. Awaits for someone to call . Sets the event in the signaled state. Whoever is waiting on , would wake up. An async wait handle which is somewhat like the manual-reset wait handle. When in non-signaled state, holds the current awaitable. To signal, the source is replaced with NULL and set as complete. Resets the state. Awaits for someone to call . Note that unlike the system event handles ALL the waiters would be awakened when set, not just the first one. Sets the event in the signaled state. Whoever is waiting on , would wake up. Sets the interval for invalidating the loaded content cache. If the duration between subsequent requests is longer than the specified interval, cached value will not be used to avoid loading. The duration for invalidation interval. If not specified, the default invalidation interval will be used. The updated HeuristicStatefulUrlLoader instance. Allows user to customize the way content will be loaded. Default is loading via HttpClient. The loading approach to use. The updated HeuristicStatefulUrlLoader instance. Allows the user to enable local caching on disk for the content and the timestamp of the loaded content in a specified cache directory. The directory where the content and timestamp cache files will be stored. If not provided, a default path will be used. The HeuristicStatefulUrlLoader instance with persistent caching enabled. Thrown if the cache directory is not a valid, absolute path. Checks whether CachedContent is outdated or not using Invalidation interval True if CachedContent is older than Invalidation interval or empty, otherwise false Asynchronously loads content from the specified URL or if loading failed returns cached content. The content as a string, or null if both loading failed and cache is empty. Asynchronously loads the content from the specified URL. String with the loaded content, or null if the content was not loaded successfully. Asynchronously saves content and timestamp of the HeuristicStatefulUrlLoader to a file in directory for persistent cache Asynchronously loads content and timestamp of the HeuristicStatefulUrlLoader from a file in directory for persistent cache Returns content or null if loading failed Retrieves the file name from a given URL by hashing the URL string The hashed file name Gets or sets a callback method to validate the server certificate. A callback method to validate the server certificate. An async semaphore to prevent opening too many objects at the same time. Which is not supposed to be a problem, they have their internal limit and should await, but it's been observed that something breaks under intensive use and all further download attemps are blocked. Limits the number of dloads from the same server. Applied when we prepare a specific request. The default limit is 2 in .NET since ages. For current massive workloads this is suboptimal, and e.g. Nuget 5 would also increase this to be 64. With poor connections, TCP/IP overhead limits bandwidth dramatically on ack/resend, so running multiple downloads at the same time increases utilization on bad connections as well. Modern servers wouldn't care much I believe. Initiates the HTTP download. Retries several times on failures. Tries to check if the content has downloaded fully. Cancelation. The URI to download. Currently, must be of the HTTP scheme. The output stream, if user-allocated. Implementation would allocate a stream of its own if omitted. MUST support seeking for the case if the download interrupts, has to be restarted, and resuming from the same spot is not possible (if resumes are not prohibited). MUST be at position zero, otherwise the existing bytes are assumed to be partially downloaded content to be resumed (if resumes are not prohibited). Optional. The progress for user feedback. Optional. The proxy server to use. Optional. Flags. The stream to which the data were downloaded ( if user-supplied, or the implementation-defined stream, which does not need disposing of in this case). Initiates periodic reporting in the background to help diagnosing problematic downloads in the logs. Does one attempt, must not throw out unless very fatal, return the exception instead. Total size were explicitly reported as unknown, or were reported inconsistently. Locked with . Reflects last value which should be in the progress On the first attempt. Only sent/received once. The transfer were interrupted and were resumed without dropping all the bytes we have. Resume were not possible, dropped all the bytes we have and restarted. Optional. The HTTP Credentials. Optional. The HTTP Method. Optional. The value of the User-agent HTTP header. Prevents from downloadig file in parts. A retry would retry from scratch and not resume from the same position. Does not retry/resume if the first attempt fails. Does not pause between the next attempt (e.g. if network is temporarily down, to not waste all attempts in an instant). Optional. The content to be uploaded with the request. Optional. If is given, specifies custom content type for it. Advanced. Overrides various timeouts starting with TimeoutAtomic… in . Those timeouts prevent from unexpected freezes in server operations and shan't be hit with normal servers. However, some servers might be implementing REST-like blocking APIs for lengthy operations, so that opening a request might await on queue for access to server resources, and getting the response might await on the operation itself, each of these possibly lasting for tens of minutes. This control allows to lift the limitations, all at once. Individual tweaks might be exposed as well, but at this moment this is not needed. or means no timeout. A NULL value means the operation-specific timeout from . The timeout for each of the download operations (attemps). Gets passed to the HTTP request. or means no timeout. A NULL value means . Size of the chunks we are reading from the receiving stream. Making them too small might be suboptimal with larger payloads. Making them too large has two problems: (a) LOH hits, (b) progress is only reported in between chunks, so with a very large buffer we might not be getting progress reports. When Web server reports a failure, wait at most this time for the full response error message. Timeout on opening the request stream for uploading the request payload (if present), on each attempt. NOTE this does not include the time for uploading the payload itself, just opening the stream. Timeout on getting the response object. NOTE this does not include actually downloading any bytes, just the initial opening of the response. Sanity time limit on writing to the local output stream, or reading from the local stream with content for uploading, if async API is used (unless it's a well-known mem stream). Timeout on one async stream operation with one buffer of size over the remote stream (upload for sending request payload, download when downloading the response body). This does not cover the error text, see instead. NOTE this is not timing out the whole download/upload operation, just one chunk. We assume that if bytes are coming TOO slowly, or got stuck and not coming at all without breaking the connection (happens on mobile internet), we should rather drop this attempt and re-initiate, since we're good at retrying. In order to get varying results for multiple oracle instances, there must be a shared Random object. Some network/transport/algorithm error. Like 403,404 — should do a few attempts anyway, but not too many. The dload were interrupted, but resumed successfully from the same spot and more bytes were received, the progress is going, no waits, more attempts. Exception from the last failed attempt. For background logging, slow path. Duplicates the code in , as borrowed from CoreCLR, with the following differences: (1) Parses only for AllowLeadingSign+AllowExponent+AllowDecimalPoint. No currency, no thousands. (2) Parses only for the Invariant Culture, only dots for decimal points. (3) Operates on the memory pointer rather than a string managed object. This is the key point. (4) Does not need a terminating zero at the end of the string. This allows to parse a part of the input stream. (5) The input is in bytes, and is assumed to be in a multibyte encoding such as ASCII or ANSI or UTF-8 — for normal doubles, that's no difference, with the exception of the “∞” char which might occur in the in R mode, which is expected to be expressed as three UTF-8 bytes. Any unexpected byte value aborts parsing. Duplicates the code in , as borrowed from CoreCLR, with the following differences: (1) Parses only for AllowLeadingSign+AllowExponent+AllowDecimalPoint. No currency, no thousands. (2) Parses only for the Invariant Culture, only dots for decimal points. (3) Operates on the memory pointer rather than a string managed object. This is the key point. (4) Does not need a terminating zero at the end of the string. This allows to parse a part of the input stream. Façade for parsing from a regular string, mostly for testing purposes, as it makes a slower version of . exponents for both powers of 10 and 0.1 // exponents for both powers of 10^16 and 0.1^16 The NumberToDouble method from number.cpp. ASCII chars, numbers only, buffer must be long enough for NumberMaxDigits (plus NULL), has meaningful bytes. Number of meaningful digits. We needs it during upgrading from nunit2 to nunit3. Wish you good mood. Represents a dynamic data collection that provides notifications when items get added, removed, or when the whole list is refreshed. Adds the elements of the specified collection to the end of the ObservableCollection(Of T). Removes the first occurrence of each item in the specified collection from ObservableCollection(Of T). Clears the current collection and replaces it with the specified item. Clears the current collection and replaces it with the specified collection. Initializes a new instance of the System.Collections.ObjectModel.ObservableCollection(Of T) class. Initializes a new instance of the System.Collections.ObjectModel.ObservableCollection(Of T) class that contains elements copied from the specified collection. collection: The collection from which the elements are copied. The collection parameter cannot be null. Reruns clt natively under Windows ARM64 because .NET Framework AnyCPU apps run as emulated x64 by default (see https://github.com/dotnet/core/issues/7709). Tool for safely running console tools with redirected output. Typical usage for getting output of unix commands. Default timeout is 1 minute If the clt was run on windows on NETCore.App (it is the case if cross platform tool it started as dotnet global tool) this method helps to run the clt using proper runtimeconfig with specified suffix So we will have the first process (which runs on NETCore.App as runner and calls this method) and the second (which runs on proper runtimeConfig and do the job) Features: 1. The second process can properly work with stdin/out/err 2. Returned exit code will be propagated from second process to the first 3. The Ctrl-C, Ctrl-Break signals won't affect the first application (it still will be waiting for the second application exit) 4. If the first process is terminated the second is also will be terminated (jobs are used as in InvokeChildProcess) Path to the clt assembly The suffix to the runtime config. The path to config file will be without extension + .runtimeconfig + + .json> Propagated exit code Throws exception in case it is not possible to run second application The method reruns the application on proper runtime config if needed see for details The code is copy pasted from . We cannot that class because it uses JetDispatcher which is not available when we run code on NETCore.App on windows. The code is copy pasted from . We cannot use that class because it uses JetDispatcher which is not available when we run code on NETCore.App on windows. Helps with invoking a child process during a build. The default timeout for running child processes. Originally, when this were used for spawning builds in child processes, this were limited to 1h. But with all the other uses, this is not a safe default anymore. Lists the processes which are currently running and belong to the job. Copy constructor. Be prepared to have it binary incompat when the number of parameters changes. By default, a child process inherits all of the environment variables of the parent process. This dictionary allows to modify the list by setting the new ones or removing existing ones (by setting them a NULL value). Optional. If set, overrides the call to Windows NT CreateProcessW with a call to this function instead, with all the exact parameters as designated for the system call. It is an error to set this value when the implementation is not about to call the native WinNT CreateProcessW. Gets or sets how the StdOut/StdErr streams of the child process should be pumped. NULL means that the streams should not be captured, and the process should be allowed to show its own console (if it's a console process). The initial setting is to redirect child process streams into those of the parent process (even if any of them is not a console process). Gives optional access to the child process standard input stream. Starts a process inside a Windows Job Object Assigning a process to a job object may fail, e.g. "Access is denied". There are cases when it's not an error as the process is started successfully. Specifies the machine architecture of the process to start, Windows only. Determines what happens to the StdOut and StdErr streams of the child process. MUST be given. Called for each line of the incoming stdout/stderr, unless runtime decides it would be calling instead (if defined and if runtime supports it, see comments there). Hi-level stream handler takes strings, which requires interpreting incoming bytes with a certain encoding. On NT, this is rather non-deterministic: the process is sending out bytes, there is no strict convention on how they would be encoded, even on that every stdout writer would use the same encoding for writing bytes into it. IF left NULL, would fall back to using . This is in sync with behavior. Optional. If specified, AND IF the runner supports low-level reading of the stream as raw bytes (originally, for NT native runner only), this handler would be called INSTEAD OF for any incoming bytes. Allows for custom handling for ill-defined encodings or hi-perf pumping of incoming bytes into own process' output. If given, you must be ready to be handling either or consistently. Child process StdOut gets logged into the as (or custom level) messages. Child process StdErr gets logged into the as or (or custom level) messages, depending on the setting. The logger instance (and hence the logging category) is taken from the logger passed into or its wrappers. If the message parses as a standard error or warning line (in accordance with csc/vbc/msbuild rules), then it gets logged as an error or as a warning. Allows to suppress treating StdErr lines as errors, considering them the same as StdOut. Optionally changes the logging level for non-error messages from its default . Child process StdOut gets piped into the parent process StdOut. Child process StdErr gets piped into either StdErr or StdOut of the parent process, depending on the setting. Allows to suppress treating StdErr lines as errors, considering them the same as StdOut. Forces to use high level line-by-line text redirection. Handle MUST be closed after use. This is a crude initial prototype API for handling child process StdIns. Let's enhance when we have a base of actual usages. To use, set before the process starts, and call after it does. This MUST be set to True before starting the process. Isn't possible to turn on this mode later. Writes to the standard input of the child process, if it's been opened by setting before it starts. Only available while the process is running, check the return value (or turn into an exception) if you are interested in handling errors. Closes the standard input of the child process, if it's been opened by setting before it starts. Only available while the process is running, check the return value (or turn into an exception) if you are interested in handling errors. Tries to get all of the immediate child processes for a given process. Might accidentally mix processes up if the parent process terminates and its ID is reused. Recursively gets all of the child processes for a given process. Might accidentally mix processes up if the parent process terminates and its ID is reused. Indicates if the process is 32 or 64 bit. process to query true: process is 64 bit; false: process is 32 bit Tries to get the parent process for a given process. Might accidentally mix processes up if the parent process terminates and its ID is reused. Initiates the process graceful shutdown by closing its main window. Optionally, kills the process abruptly if the shutdown fails to complete as the timeout expires. The process to kill. Could be own process. Behavior flags. The timeout to wait for the process to shutdown gracefully (before exiting or killing the process). Ignored in some combinations. Optional logger Whether the process has exited. Encodes an env string with a multibyte-character-string encoding, like CoreCLR Debugger Shim would expect when running under Linux. Gets the list of processes attached to the given Job object (or its child Job objects). Gets the main module name (name without extension of the main executable file, for example). Usually same as ProcessName, but faster. Querying the process name thru the process APIs involves doing the full enumeration, which might be undesirable in low-level code. Allows to guise a native HANDLE as a NetFx waitable handle. flags. After sending the shutdown control, does not return from the method until either the timeout expires or the process exits. If the process fails to exit within the timeout, the process is killed. If , this method performs a non-pumping wait; otherwise, a timer is used to wait async. . . . . Passes False to bInheritHandles. Creates a custom pipe for the stream, gives the reader pipe end handle in . Creates a custom pipe for the stream, gives the reader pipe end handle in . Allows to define a custom lifetime for stdin in cases when we need to close it before process closed (i.e. if we need to send an input and close stream to inform the process it may process the input) Creates a custom pipe for the stream, gives the writer pipe end handle in . The process will stay in suspended state after start. Optional. If set, overrides the call to Windows NT CreateProcessW with a call to this function instead, with all the exact parameters as designated for the system call. It is an error to set this value when the implementation is not about to call the native WinNT CreateProcessW. Specifies the machine architecture of the process to start. Handles to the standard streams of the child process, whichever were requested to be piped, others are NULL. A delegate with the exact ::CreateProcessW prototype. Formats product headline like 'Product Name 2017.3 EAP 8 build 111.0.20171124.0-eap08. Copyright © 2009-2017 JetBrains s.r.o.' according to https://youtrack.jetbrains.com/issue/LegalCZ-9 This class is similar to JetBrains.Application.BuildScript.ProductHeadlineBuilder but might be used in runtime. At some point, Platform is no more able to provide a consistent set of assemblies whose versions match their references. The breaking point were the Unsafe assembly. From then on, every NetFX runtime must have binding redirects in place to enforce compatibility, or, in some cases, assembly resolvers doing the same. This class lists assemblies which must be redirected, and the target versions. As a dependency of System.Memory, must also be present in binding redirects (with code base). When we are running in LoadFrom context (e.g. as a VS extension), loading System.Memory in a LoadFrom context of one of our own DLLs would find it in the folder of our assembly, but Fusion hits a bindingRedirect with a codeBase for it. As a result, System.Memory gets loaded in a Load context instead (!). All of its references are then looked up in the global context too, and not in LoadFrom of our assembly anymore, so Fusion does not look for them in the folder of our assembly, and bind fails. See RSRP-499758 for case details. The set of assembly identities into which assemblies with a matching simple name and token must be redirected. as policies (incl redirection rules, no codebase of course), ready for making into xml configs. Makes the ready for use trivial app config file with just the redirections. This is a convenient wrapper around Registry API. It recognizes registry paths of the XPath syntax Gets the MIME type of the file by looking up Registry for its extension. In a generic method, allows to reinterpret-cast a value type to the matching generic parameter type without boxing it. Call on POD structs only! Reinterpret-casts types bluntly. Dangerous! Do not modify! Provides raw access to the parts, for renderers which used to peek into the internal field when their UIIinteractive code were in the same project. Not sure if this is really perf-crit to allocate an object with , but why risk a slowdown in this legacy code. Let's give it raw access. Information about a font, in resolution-independent and framework-independent (mostly) manner. This is the em-size of the font, aka character size, or character cell height minus internal leading. The units are device-independent pixels (96 DPI pixels, Avalon pixels, logical pixels). This isn't in points, which are 72 DPI pixels. The value is directly usable for Avalon font sizes. For WinForms, it must be scaled to the DPI, and units must be set to pixels. Do not use resolution-independent units such as points for WinForms, because often the rendering engine does not know the correct DPI value at render time, better use our live DPI routines and get the physical pixels ourselves. String name of the font family. Gets the font style (variation / weight), in a framework-independent manner, basic values only. Don't touch any special chars, render them as is. Handle ampersand for mnemonics by treating them as special chars and removing, but paint no underline. Handle ampersand for mnemonics by treating them as special chars and removing, and paint the underline. StringEncryption is a wrapper of System.Security.Cryptography.SymmetricAlgorithm classes and simplifies the interface. It supports customized SymmetricAlgorithm as well. Supported .Net intrinsic SymmetricAlgorithm classes. Constructor for using an intrinsic .Net SymmetricAlgorithm class. Constructor for using a customized SymmetricAlgorithm class. Depending on the legal key size limitations of a specific CryptoService provider and length of the private key provided, padding the secret key with space character to meet the legal size of the algorithm. Like an MFC Archive, handles read and write operations with the same API. For reuse when we need max buf size, allows to avoid field reads. If the current is a , gets its length, in bytes. Otherwise, throws. Reads the value of the current String token as a managed string. Optional. If defined, will check that it's equal to token, and throw an exception otherwise; no heap memory will be allocated unless the string is too large. Reads the value of the current string token into a user-supplied buffer. Buffer space to write the data into. This buffer is allowed to be larger than the size of the current string token value. Check the return value if you need a buffer of an exact size. A subrange of truncated to the bytes actually read. This length is exactly known before you call the method as (NOTE: when this method returns, the value of that method would already refer to the next token). If an error happens on a closing bracket of a using construct, this is often due to an exception somewhere inside the bracket (which unbalances the rest of the reading within the bracket). Throwing from the closing bracket is undesired because if there is an exception being propagated, said exception (which explains everything) will be totally lost and replaced with a useless exception about unbalancing the reader. Throw out on the next regular read operation (skips are not considered as they happen on bracked closings). Skips the current token to the next one. Returns the next state. If the value of the current string token is short enough (buffer size minus some technical bytes), gets a view on it directly in the cache buffer, and advances to the next token. This is the fastest possible access to a value. A temporary range looking directly into the reading buffer, invalidated on ANY operation, use only briefly without calling other methods. Whether we could view the value, which MUST succeed for reasonably-sized values. If not, you can assume the value is really long, no efficient non-allocating methods for reading long values right now, either add one (which reads it as a sequence of span sections), or read to a user-supplied buffer. See as an example. Before calling this method, MUST be positioned at the start of the token. Processes the beginning of the next token, i.e. does not complete the token processing: * For list open/close, consumes the bracket, but does not change the levels. * For string, consumes the length and colon and positions at value start. In mode, aborts (backtracksto token start and returns False) if runs out of the precache, wouldn't pump from the stream (and invalidate any spans looking into pre-cache). Reads a single input byte in case of a precache miss. Gets the current position of the input bytes stream (note: the underlying stream might be positioned elsewhere). Reads the current string value as an encoded unsigned decimal number. Reads the current string value as an encoded hex number. Expects a string token with this , and then reads the string value from the next string token. [NotNull] Expects a string token with this , and then reads the value from the next string token with . Reads the value of the current string token and returns it as a span. If value is short enough to fit within the internal buffer, then a span view on the internal buffer is given out directly. Otherwise, allocates temporary memory within the Unsafe Writer, gives out a span view into that, and returns a disposable which you MUST dispose of to release memory. You MUST NOT use the span beyond any next operation with the reader. Dispose of this value when you are done working with the span. Generic reader function for string tokens. Reads primitive types as their ASCII text representation, strings as UTF-8, and any other type thru (, string conversion). Allocates a new buffer to read the value. Allocates a new buffer to read the value. Reads the value of the current string token into a user-supplied native memory buffer. It is advised not to allocate a new Unsafe Writer per each atomic read because the operation is relatively costly. For known small values, try to get away with direct spans. Opens-cloes the nested list. To begin the use of this object, you must open the single toplevel list. Opens-cloes the nested list. To begin the use of this object, you must open the single toplevel list. A helper which writes a double value. A helper which writes a nested list of two items, name and value. A helper which writes a nested list of two items, name and value. A helper which writes a string conversion of a typed value. By default, Newtonsoft JSON cannot handle NULL immutable arrays. This converter adds the capability. Uses the alternative JSON serializer, not the system one. Uses the alternative JSON serializer, not the system one. Uses the alternative JSON serializer, not the system one. Uses the alternative JSON serializer, not the system one. Means that the artifact should be serialized on member-by-member basis, by reading values of all public fields or properties. When restoring, values should be assigned either back to fields and properties (if writable), or to constructor parameters. Means that the artifact should be serialized into XAML. Zero-based range of lines that should be replaced: [start, end) A list of lines that should be used for replacing A list of lines that should be replaced All lines contain line ending Zero-based range of lines that should be replaced: [start, end) A list of lines that should be used for replacing A list of lines that should be replaced All lines contain line ending Zero-based range of lines that should be replaced: [start, end) A list of lines that should be used for replacing A list of lines that should be replaced Calculates single change which allows to transform to Change is presented as inserting/removing/replacing line(s). All offsets (ranges) are line-based. All lines end with line-ending character (if it is present in the content). Change contains additional ("excessive") lines which allow automatic conflict resolution. Designed to work fast on insane input - 400.000.000 characters strings Only \n, \r and \r\n are supported. It is OK because only them are supported in LineEndings.UnifyLineSeparators as well. Finds the correct place where diff should be applied to the currently present text. Supports automatic resolution of conflicts if currentLines slightly changed from the original state which existed when creating diff It is impossible to apply diff to current text Separates one big diff into several smaller ones if original diff has unchanged lines in the middle. Works only when the number of lines in the diff is relatively small (for performance reasons). Resulting diffs guaranteed to be sorted. Gets rid of the prefix and postfix lines. BEWARE, correct conflict resolution (ResolveConflictIfAny) won't be possible after that. If the diff can be matched at this position - it returns new match position for the real diff (excluding prefix line). New position can be the same as original position (if prefix doesn't exist). Returns 'null' otherwise. Checks whether two symbols are the same. Checks that one line contains normal symbol (for instance, '"') while another one - escaped ('"). Shifts one of the indices in that case but expects that both of them will be incremented by a callee. 'true' if they are the same, 'false' - otherwise Keeps line ending characters Number of skipped lines Serializable model of stack trace. Can be used for pretty presentation. Serializable model of stack trace frame. Can be used for pretty presentation. Serializable model of method's parameter. Can be used for pretty presentation. TODO (DK) Write in a right way This class gives standard folder locations for raw static utils. Any code running in shelled apps should use HostFolderLocations to get the desired locations and pass them to the corresponding utils. Only very static and basic code can use this class directly. The non-Roaming Application Data, shared for all versions and all hosts (%localappdata%\JetBrains\Shared\vAny). The Roaming Application Data, shared for all versions and all hosts (%appdata%\JetBrains\Shared\vAny). Company temp folder (%temp%\JetBrains). The Application Data Transient folder (%localappdata%\JetBrains\Transient\Shared\vAny). A version of with a shorter path, in case your usage hits the limit. Subfolder under local-app-data for caches (specifically transient stuff). Replaces the host name when not per-host. Replaces the version number when not per-wave. Goes after . Prefix for the version folder name. A wrapper for serializing a set of file items. Does not retain order, always sorts them. A wrapper for serializing a set of file items. Does not retain order, always sorts them. Pumps a span into the hasher. Make sure your data has the same binary representation across relevant platforms. Appends a single item, passes the whole body for better diag. Appends items as a set, in a stable order. Appends items as a set, in a stable order (does not re-sort if already in stable order). Minimum byte count what we expect Available bytes. It is more or equal then needBytes Return pointer to buffer Return value + points at Minimum byte count what we expect Available bytes. It is more or equal then needBytes Represents a file item which takes part in the build or other similar operations. It has a name (possibly, with partial folder path), but is not bound to any specific location on disk; it has a body, which is an immutable stream of bytes. Disconnecting file items from specific disk paths makes operations more reliable. Firstly, getting a file item means a correct dependency on its producer, while reading a disk path might be based on well-known paths or guesswork, and miss the actual dependency on the producer. Secondly, passing around file items allows running operations in parallel without aliasing over the same disk locations. All this might be achieved on disk paths as well, but has rather weak guarantees to always hold in large systems with long history. Identity ctor. The file name of this file item. Might also be placed in a subfolder. Must not be an up-going relative path. The byte content of the file. Must be an immutable stream, will be frozen by the ctor. Memory stream ctor. The file name of this file item. Might also be placed in a subfolder. Must not be an up-going relative path. The byte content of the file. Must be an immutable stream, will be frozen by the ctor. Clone ctor. Most useful for typed inheritors. Deserialiation ctor. Lazily-computed file content hash, for quickly comparing file contents. The byte content of the file. This stream is frozen, initially positioned at the beginning, and does not share its current position with other callers. A shallow clone is created for each caller. This means that (a) callers don't affect each other's stream positions, (b) there is a slight memory penalty for creating a small wrapper object on each call, and (c) the full contents of the underlying buffers are not cloned but reused immutably. The file name of this file item. Might also be placed in a subfolder. Must not be an up-going relative path. Exposes the function which is used for computing over the file content. Creates an in-memory file item from a physical disk file. When the read completes, the created file item has no connection with the disk file. The latter can be modified or deleted. Path to the disk file to be read. Must exist as a file. Its local name will be used as the name of the file item. Creates a new file by writing the content into a stream. A typed exception for the case when finds no file. NOTE that it's not 100% race-safe (yet). It targets the cases when the file is really not there. Temporarily realizes the file item as a physical disk file. Ideally, file items should be non-lifetimed and GC controlled. In reality, to optimize memory use, sometimes the immutable byte streams inside the file items might have limited lifetime. To make it worse, file items might derive these streams from some other storage different from the immediate originator of the file, and its lifetime might be even shorter. An example is when the creator of the file item artifact is deserializing from some interprocess transport stream, the stream might be short-lived. This method tries to ensure that the memory owned by this file item has no end of life. Returns a new instance only if a change were made. Returns a clone which shares the content stream, but uses a different file path. Returns a clone which shares the content stream, but uses a different file path. Does not read the file content from disk to make sure its hash matches that of the in-memory copy. Not recommended for the real installation, but can be used to speed up in some simple cases like PWC pre-extraction. For extracting a package from various artifact containers. Gets the full name of the package, based on its , including ID and Name. Dot-separated notation (classic nuget, non-roundtrip because dot separator is ambiguous; see ). Gets the full name of the package, based on its , including ID and Name. Slash-separated notation (modern nuget, roundtrips, can be parsed back because slash cannot be a part of id/name). Gets the local name of the package file with the given ID and version. Gets the identity of the package, which is the ID and Version. It's equatable and sortable. Extracts packages from a have-package collection. Common interface for entities which act as Nuget packages — either real nupkg package files, or the “nugettable” set of package parts plus metadata from which we might easily make a real .nupkg package file, but haven't done so yet. Package identity (name + version). The manifest of the package. Gets the package parts as file items. No filtering applied. Parts are sorted by their part paths as s. For most practical needs, you'd need a filtered set with effective paths, for which look for . Notes on performance. In case of a nugettable, parts are stored as file items and this provides direct access. In case of a nupkg, these are lazy promises which would decompress file content on-demand, which is a costly operation for larger items. In case of a nupkg + scattered package on disk, larger items would be served from uncompressed disk copies, if available, which should be not as costly. Gets the parts of the Nuget package (this skips the nuspec, and of course skips technical OPC package ZIP entires which are not parts). Flags to skip certain items, for speed. Allows to limit the extracted content items by a specific Target Framework. Not filtering (not ): gets the union of all the content items for any frameworks; might yield items with the same (but different of course). This is the legacy behavior. Filtering (): • Illegal if not . • Returns content items for this specific framework only. • If limiting for the specific framework yields an empty list, falls back to the original behavior as if this were NULL. This is a compatibility fix to make sure that we're still able to support projects targeting the non-solution-standard fx version and their custom nuget references. The commonly-used value would be . Gets the .nupkg package file. This might be a costly operation in case we only have the nugettable sources and will have to ZIP an OPC package together. DO NOT use for anything which does not require the actual file bytes. Uses uncompressed entry bodies in a stable order to calc digest which does not depend on the nuget representation, compressed or scattered or disk or whatever. This is most useful for local nugets which are not unique per identity. See description of . A thin wrapper which applies filtering to content items in default target framework. “Content items” means we only take those items for which is defined, i.e. those recognized as content items by our system. That's flag. The default target framework is taken from ( filter parameter). See description of . A thin wrapper which applies filtering to content items in default target framework. “Content items” means we only take those items for which is defined, i.e. those recognized as content items by our system. That's flag. The default target framework is taken from ( filter parameter). Gets the entries of the Nuget package (this only includes files of the package, not the nuspec or any service OPC parts). Might limit the lifetime of the entry bodies, if you know when you'd be needing them. The implementation is ready to take a NULL here and make them ever-available. Flags to skip certain items, for speed. Allows to limit the extracted content items by a specific Target Framework. Not filtering (not ): gets the union of all the content items for any frameworks; might yield items with the same (but different of course). This is the legacy behavior. Filtering (): • Illegal if not . • Returns content items for this specific framework only. • If limiting for the specific framework yields an empty list, falls back to the original behavior as if this were NULL. This is a compatibility fix to make sure that we're still able to support projects targeting the non-solution-standard fx version and their custom nuget references. The commonly-used value would be . See description of . A thin wrapper which just passes no flags and for the target framework, hence no filtering, all possible entries in the package which are not service parts. Might get Nupkg or our Nugettable. For the case when we do not care. When you want to compare packages by their real content, gives some entity which would do a deep check on bodies regardless of the format. TODO: make sure works for nugettable vs. nupkg Retrieves the Nuget entries with their bodies available for the duration of the user callback. On filtering parameters, see . See description of . A thin wrapper over which just passes no flags and for the target framework, hence no filtering, all possible entries in the package which are not service parts. Wraps a Nuget Package Manager together with its settings (like what the package source is and where the default local Packages directory should be). Has extension methods with our implementations for reliable package retrieval and extraction. Nuget settings on which this repo is running, unless operating in the fallback-to-default mode. The package repository for retrieving packages from the Nuget uplink. Uses own caching on disk. Gets the compressed length of the entry, if available. Allows to tell uninitialized structs, e.g. with TryGet methods. Can tell the effective path (logical path with content folder name removed). Gets the uncompressed length of the entry without actually inflating the bytes. Inflates the part into an uncompressed copy in the memory. Uses the path. Inflates the part into an uncompressed copy in the memory. Uses the full part path of the file, . Inflates the part on-demand. Prefer this method if you only need to peek into the head of the stream, or you want to read it streaming-way without leaving bytes in memory. Guarantees the stream has random-access capabilities, but this comes at a cost of doubled memory use. Call unless you need random access. The stream. Might want to dispose of, but this is not necessary. Inflates the part on-demand. Prefer this method if you only need to peek into the head of the stream. Guarantees the stream has random-access capabilities, but this comes at a cost of doubled memory use. Call unless you need random access. Inflates the part on-demand. Prefer this method if you only need to peek into the head of the stream, or you want to read it streaming-way without leaving bytes in memory. The stream might be returned as sequential-only, depending on the ZIP options used. Filtering magic for . Only take those items for which is defined, i.e. those recognized as content items by our system. The empty folder marker file, , affects filtering and folder preference, but is skipped from being returned in the list. Do not skip empty folder maker. We now do not skip these files by default and return them, otherwise the folders disappear and this affects TFX preference. The content-items extraction () skips them on content filtering phase; in raw modes, you should do this yourself. Modifier for mode. Historically, we've been taking the (lib) folder from non-ours packages. With newer nugets and multiple supported target frameworks, it is sometimes needed to take the specifically tailored references from the (ref) folder. Still falls back to lib folder if no refs. Modifier for mode. Historically, we've been taking the (lib) folder from non-ours packages. With newer nugets and multiple supported target frameworks, it is sometimes needed to take the specifically tailored assemblies from the (runtime) folder when running on a specific target system. Still falls back to lib folder if no refs. Modifier for mode. Historically, we've been taking the (lib) folder from non-ours packages. With newer nugets and multiple supported target frameworks, it is sometimes needed to take the specifically tailored assemblies from the (runtime) folder when running on a specific target system, but they should be used together with regular libs, so this reads from both content and runtime folders. Takes a file representation of a nuget package and makes an interface to it. This might be either a .nupkg file, or an uncompressed file of a nugettable set, or else. Can read output of , though saving it again might possibly change format. Getting the might not be cheap if it were not a .nupkg file already. Takes a .nupkg file and wraps as an package. For this sort of package, getting the nupkg file back is a cheap operation. However, accessing file contents means doing decompression and mem allocation. Takes a .nupkg file and wraps as an package. For this sort of package, getting the nupkg file back is a cheap operation. However, accessing file contents means doing decompression and mem allocation. NuGet Settings with expanding environment variables in values Implemented in NuGet 3.4 Flag indicating whether this file is a machine wide settings file. A machine wide settings file will not be modified. Loads user settings from the NuGet configuration files. The method walks the directory tree in up to its root, and reads each NuGet.config file it finds in the directories. It then reads the user specific settings, which is file in if is not null, If is null, the user specific settings file is %AppData%\NuGet\NuGet.config. After that, the machine wide settings files are added. For example, if is c:\dir1\dir2, is "userConfig.file", the files loaded are (in the order that they are loaded): c:\dir1\dir2\nuget.config c:\dir1\nuget.config c:\nuget.config c:\dir1\dir2\userConfig.file machine wide settings (e.g. c:\programdata\NuGet\Config\*.config) The file system to walk to find configuration files. The user specified configuration file. The settings object loaded. Loads user settings from the NuGet configuration files. The method walks the directory tree in up to its root, and reads each NuGet.config file it finds in the directories. It then reads the user specific settings, which is file in if is not null, If is null, the user specific settings file is %AppData%\NuGet\NuGet.config. After that, the machine wide settings files are added. For example, if is c:\dir1\dir2, is "userConfig.file", the files loaded are (in the order that they are loaded): c:\dir1\dir2\nuget.config c:\dir1\nuget.config c:\nuget.config c:\dir1\dir2\userConfig.file machine wide settings (e.g. c:\programdata\NuGet\Config\*.config) The root directory. The user specified configuration file. The settings object loaded. Order is most significant (e.g. applied last) to least significant (applied first) ex: c:\foo\nuget.config c:\nuget.config Wrap all IO operations on setting files with this function to avoid file-in-use errors Specifies filtering by target framework when fast-extracting the nuget packages. The NULL value means the toolset-default targetfx should be used. Gets the union of all the content items for any frameworks; might yield items with the same (but different of course). This is the legacy behavior. Filters by the netfx of , which is the default target netfx version for the managed projects in the solution. This weird combination is required so that the NULL value of the structure were the preferred omitted-default value (use current toolset). Filters by the netfx of the .NET Core runtime version we're currently targeting in our codebase. This is a minimum supported version, not a current .net core runtime version. Most like the class, but with correct equality members implementation. Dot-separated presentation of the name. <PackageId>.<Version> Classic nuget. Might not roundtrip because parsing of this form is ambiguous if package name ends in numbers. This is the default. Some.Package.Name.1.2.3.4 Slash-separated presentation of the name. <PackageId>/<Version> Newer nuget. Does roundtrip. Some.Package.Name/1.2.3.4 Opens the meta stored in the folder (usually, the solution's Packages folder) for the duration of the lifetime. Deserializes when opening, serializes upon termination of the lifetime, holds the lock to the file the whole duration. When to serialize back and close file. Usually, the solution Packages folder. The timeout to wait for a lock when trying to open metadata on a nuget entry in the Central Cache or a Local Restore folder. This might mean that another thread/process is also performing an operation on the same package location. The supposedly most lengthy operation is package download, which also locks the folder (why not? you cannot local restore a package before you download it. and you do not want to run simultaneous downloads). We got large packages and possibly slow connections. Do not limit the process. Validates the files expanded from out of the package. Their size is checked against the package contents, and their stamp must all match this one. Validates the copy of .nupkg stored in the expanded folder. Validates the copy of .nupkg stored in the expanded folder. String representation of the package semantic version, to defer costly parsing — this speeds up mass-serialization considerably. Opens the package local expansion metadata for a single package, and locks access to it by holding an exclusive lock on the file for the duration of the lifetime. The metadata is in the format and describes the single package to which this directory (either as a local-expand location, or just a caching place for its nupkg). The metadata helps control its integrity. If the metadata does not exist, an empty one gets created. When the lifetime ends, the new value is written to the metadata file. Locking access means that the file is opened exclusively (with awaiting for it to become available), and is held locked for the , thus protecting the from unexpected modification by another party. Multiple concurrent tasks or processes can safely request caching/expanding a package this way. The metadata is stored in directory attributes in the stream named on supporting file systems, or in a file under the same name concatenated to the directory name otherwise (so it's outside the dir itself). Beware opening on a symlink: on NTFS, the attributes would go on the symlink target, but otherwise it would be on the symlink source. The returned box would be NULL if record missing/invalid, or the valid record. Upon lifetime termination, the box contents would be written if reference changed from the previous one. Reads the package local expansion metadata which can validate that it has not been tampered with, written right into the package expansion directory extended attributes (more specifically, an alternate data stream named ). This is used in case we're linking package folders from the common storage, so the per-Packages-folder local metadata file is not sufficient because it does not know about packages written to the central storage by other parties. See . “Try” because the filesystem might not support this (but in that case linking the packages folders to the central storage won't be supported either). Operates on strings, without parsing the semver. Profitable for mass-serialization. Package's been expanded — now it has a folder on disk. Plus some stats. Gets the number of files in the expanded package. This includes the copy of the package file itself. Gets the number of bytes the package took after expanding. Note that this includes the package file itself, so that's at least double the package size if the parts were not compressed in the package, but usually even more. Gets whether the package files had to be written (or rewritten). If all the files are already there and OK (same set, same size, same stamps) then this would be False. Represents a central NTSF folder into which all packages are actually expanded upon local-restore and then linked into individual Packages folders with directory junctions as needed. The actual folder path might be NULL, which means that the central folder is not available (e.g. due to the lack of filesystem support for junctions), and local package folders must be used normally in such a case. Name of the environment variable which suppresses NuGet local cache usage for download issues investigation. Should parse as a boolean value. Time after a folder in the central cache or backlog (with either just the package or its local restoration) is last accessed for package download or local restore, before it's deleted. Does not let the nuget cache folder grow infinitely. Creates the custom directory (does not check OS features, use if not sure, use for machine-default location). If the volume supports junctions. Always returns a non-NULL instance, but it might have a NULL path. Creates at the default machine location, if OS and file system support the necessary features. Restores a specific set of Nuget package into the packages directory, mostly the same way as Nuget will do. As opposed to the standard Nuget procedure: • Ensures the folder contains no more packages than the retrieved list, to prevent projects from using non-whitelisted pkgs by accident. Operates on the Backlog folder to quickly retrieve such packages whenif we switch context. • Ensures the expanded content still matches the original packages (the file set and their content, by timestamp of the last time we wrote them). • Fixes exceptions in Nuget which probably resulted from some race (NP-1199). • Operates on the already-retrieved package body, as an artifact object. • Uses a slightly optimized procedure for accessing the artifact body (not so important). Name of the env var which suppresses validation of the expanded nuget packages. This could be used for debug purposes when you modify an already-expanded package and run experiments with the new content. In the normal course of action, local restore would repair corruption with the original contents. Should parse as a boolean value. Whether to set the NTFS Compressed attribute on folders with expanded nugets, so that they occupied less disk space (e.g. for Platform SDK and VC Build Tool nugets). Set to 0 to compress no packages, or 1 to compress every package. A valid value in between specifies the compression ratio (compressed div uncompressed) of the original nuget under which compression should be applied to expanded disk files, ie do not compress if files are noncompressable. Gets relative path from the to the to the folder in which expanded packages not currently referenced are hidden from accidental use in project references for potential reuse when we switch a branch and need them again. The name of the folder does not match the regex on Package ID (\w), so it shan't interfere with normal packages. Directory to the , if were supplied and we decided to put it to use. Tracks the folders in Packages directory which we have used — we will hide unuseds. Limits concurrent substantial write operations (eg metadata ops are not limited here, supposing we're on SSD). Opens the session. You can declare more packages as used while the session is open. The intended use is to close the session as soon as you are done with the restore, and then proceed using the packages — it's a restore-time session, not working-time session. Upon close, session will clean up packages you have not touched. The Packages dir. Note that it's not the product home dir but usually the Packages folder under it. The async strategy. Optional central cache. If gives a non-NULL dir, and packages folder supports junctions, will use directory junctions to the central cache instead of the local backlog dir. 0 lazy delayed, 1 yes, -1 no By default, is called automatically when session is closed, so that the folder only had those packages mentioned in the session. By changing this value you can prevent this cleanup. The untouched packages are not removed, but are not validated either. Cleans up old unused packages in the backlog folder. Do not terminated the session lifetime while running. This is done automatically when session is closed, but you can call it at any time as well. Adding more packages won't break things. All packages which were not mentioned in this session are hidden from the packages directory, to make sure they're not accidentally referenced without also adding a reference to the package. To clean up the backlog folder of the very old packages, call (called by session async helpers automatically). As the first stage of the local restore, tries to see if there's a potential location with already expanded package files. Fast track: executes always. For packages with effectively compressable content, might be worth setting the compressed attr on directory. Called when new expansion has been done for the package. Thus assume we've taken the lock for lengthy FS writes, and have gone to another thread. The directory should be the real dir (not the soft link source). Validates that the Central Cache has a correct expand directory for this package, with all the files intact. NOTE: Central Cache directories might have either just the nupkg file (if it were only downloaded), or the full expanded package. Here we only need the latter. Lifetime for this single package expansion act (not the session nor anything larger). The package. The real expand dir, either the local one, or the central cache one in case of the central cache. Expansion metadata for validation (obtained from the correct place, ie either local or ccache). When validation fails, try to fix it by writing/deleting files. Backlog folder, can use it to supply the missing files. Reports encountered errors here. Enum which gives out folders with unused packages, to be backlogged or cleaned up. Gets if we've gotten ourselves a flag to suppress all nuget validation Backlogs unused packages, so that there were no accidental references into them from around the solution. Creates a to return and caches it. Proper caching is why this method exists at all. Looks up the folder name in , asserts that we restored the same package ID into it. Gets the record with metadata on package expansion, which allows to validate the actual package files on disk against what must be there in a valid expanded package. Metadata is looked up in two places: (1) on the expansion directory itself — this supports the case when packages are expanded into the central storage and then linked with junctions to actual package folders; (2) in the local-meta file in the Packages folder, which supports the case without junctions. ID of the package to look for. The directory into which the package is expanded, if applicable. Looks for metadata on the directory itself, which is the case with the junctions way. This is the preferred location. The local-meta file from Packages, if available. Checked after the on-dir storage. Supposedly, they're the same. When the session closes, all of the packages which are in the session's Packages dir and were not mentioned within the session are considered unused in the current layout and are moved to the Backlog location, so that they were not accidentally referenced in solution files. When the session closes, all of the packages which are in the session's Packages dir and were not mentioned within the session are considered unused in the current layout, but are left AS IS. This is applicable when the same folder is reused by multiple unrelated sessions, and each session does not cover the whole set (like with test data). Returned when looking up a package in the central cache. Holds the lock while the lifetime is open. Allows to set a new entry to the cache. Gets the Nuget package, either the originally retrieved from cache, or after assigning the new value. Assigns a new package. Would be written to the cache when the lifetime cache ends. Mainly exists as a separate struct to hide these params from the API and make them less likely to be used. Custom local name for the subfolder for this package under the packages dir. Caller must make sure names do not clash, this will be asserted within the session. Allowed values: • NULL — means no customization, use canonical name based on package identity, dot-separated. • "" — same as NULL. • A one-component path — use this for the folder name. • A path with more than one component, or an up-going path — an error. Currently must be a one-component name. Must comply with the charset valid for package names. Nuget package helpers which might be specific to build-related types, but are not specific to build semantic. NugetApplicationPackageConvention — Nuget package layouts, locations, constants, etc for application shell aware needs. — very generic Nuget helpers in the Util, not aware of Build nor Application Shell packages layout. NugetHelpersBuild — Nuget services for supporting the Build infrasturcture and build operations not aware of the Application Shell packages. NugetHelpersShell — Nuget services for working with the Application Shell packages. NugetApplicationPackageTasks — Application Shell packages logic. We do not want to run an unbounded number of bulk nuget operations in parallel, they would use up the same HTTP (for download) or disk (for mass reads). Also, progress messages would mix up. Controls whether applies to package retrieval too (or only to local-restore). The latter is disk-intensive, while there's no big reason not to parallel retrievals. Add to the package ID of the main package to get the ID of the Nuget package with the program database for that subplatform, separated with a dot. Don't use except for in legacy build-only methods. All new (async/parallel) usages should correctly write into the logger of the caller. Creates the source repo, with per-machine caching enabled. Creates the source repo, with per-machine caching skipped. Ensures that this reference represents the exact package identity (rather than a version range), and returns that identity. Restores the Nuget logic for filtering dependency sets by the target framework. Calling Nuget native API has a drawback of throwing exceptions when it finds surprising records in the Registry of the local machine, and also makes excessive allocations. Gets the package by ID. A missing package is an error. Gets the package by ID, plus all its references, transitively. A missing reference is an error. Gets the packages by ID. A missing package is an error. Gets the packages by ID, plus all their references, transitively. A missing reference is an error. Gets the package by ID, plus all its references, transitively. A missing reference is an error. For a set of packages with binaries, tries to look up corresponding packages with native images in the total packages set. Subset of binaries packages. The total set of packages to consider. Native image packages are per-runtime, which runtime to look for. The set of found additional native image packages. For a set of packages with binaries, tries to look up corresponding packages with symbols in the total packages set. To filter out native symbols, look for the FindPackagesWithManagedSymbolsAsync method. Subset of binaries packages. The total set of packages to consider. The set of found symbol packages. Gets the effective path of the embedded file in the package. If the package follows the DotFiles folder convention, cuts this folder name. Otherwise, takes what Nuget thinks to be the effective path of the file. Gets the local name of the package file with the given ID and version. Gets the local name of the package file with the given ID and version. A helper to get a group of packages in one take. Adds progress reports for the whole group process. The packages to be retrieved, as the request structures which allow to match the request with the result without additional lookups. A noun-like title case or lowercase topic for this operation (e.g. "Build Script Package References", "CDB Self-Debugger"). Your parent logger. The impl creates an own logger instance to track messages from this bulk operation. Those package items which were retrieved (no NULLs). You do not need to make unique or stabily-ordered. Gets the single package, throws if failed. Runs restore for the list of the given packages against the given session (which defines the target directory for restore and the unused packages behavior). See other overloads for options to create the session automatically. In this overload, you already have the session. The packages to restore with the session, one by one. A noun-like title case or lowercase topic for this operation (e.g. "Build Script Package References", "CDB Self-Debugger"). Async driver. Error reporting. Optional. Extra customization for each package local expand behavior. The description of the restored package (nullity depends on ). Creates the session with recommended parameters and runs restore in it for the given packages. The limiting lifetime for the async activity. The list of packages to be restored within this session. The target directory for restore, corresponds to the Packages directory under the solution. See for possible overrides. What to do with unused packages in that . See for details. A noun-like title case or lowercase topic for this operation (e.g. "Build Script Package References", "CDB Self-Debugger"). Async driver. Error reporting. Optional. Extra customization for each package local expand behavior. The description of the restored packages (depending on , might be missing some of the original packages in case they failed). Creates the session with recommended parameters and runs restore in it for the given packages (when you have only one; use the other overload if there are many). The limiting lifetime for the async activity. The list of packages to be restored within this session, if there's only one package. Do use the other overload if you have many. The target directory for restore, corresponds to the Packages directory under the solution. See also : the package contents would be either in a subfolder named after the package identity (default), or the given custom path. What to do with unused packages in that . See for details. A noun-like title case or lowercase topic for this operation (e.g. "Build Script Package References", "CDB Self-Debugger"). Async driver. Error reporting. Where package contents would be under the : • NULL (default) or "". As with usual multi-package restore, each package would be expanded into its own subdirectory under , named after the package identity, dot-separated. Example: PackagesDirForRestore/PackageName.1.0.0/<files here> • A custom one-component path. You can choose a custom subfolder name (for example, a shorter one). You can not actually avoid the subfolder at all, because on non-NTFS the metadata file about the package expansion goes into the base packages folder next to the actual expansion directory, so without a subdir this would go ABOVE , which might litter directories outside your workdir for example. The description of the restored package (nullity depends on ). Combines together retrival and restoring. Gets the package in a reliable way, working around problems like inability to retrieve bytes of the actually-returned package. Gets the package in a reliable way, working around problems like inability to retrieve bytes of the actually-returned package. Gets the effective path of the embedded file in the package, by our convention, only from the Lib or DotFiles folders. If the package follows the DotFiles folder convention, cuts this folder name. Otherwise, takes what Nuget thinks to be the effective path of the file in the Lib folder. The effective path, and whether the file were within the Lib folder in our or Nuget-standard convention. Makes a suffix to be added to a Nuget package ID if we want to make it specific to this runtime.. No specific Nuget convention for this, just something to be specific. MUST be specified. The package to retrieve. Requester's functor to process the result (as this is the most natural mapping of the result to the identity for the requester). Uses alternative methods for introspecting Nuget packages, which can give up to 2x total speed and greatly reduces intermediate memory usage. Does not reference the Nuget itself, so is netfx35-friendly. Notes on not disposing of the ZipFile: running off an immutable memory stream, and never modifying the ZIP, there's nothing to dispose actually. Notes on no filter: as we're not retrieving the content aggressively, it's no big deal to postfilter. Filter is critical for fns which return bodies already. Notes on thread safety: looks like Nuget allows to access underlying streams in parallel OK. Looks up the relationships file in the package, and reads the Nuget Manifest relationship target to learn the part which has the package manifest. Gets parts of the package without semantical filtering. Technical filtering happens on OPC level (OPC supplementary ZIP entries) and on Nupkg level (the manifest package part). Using Nuget's own package for getting a manifest results in copying the full package stream and then copying the metadata a few times. Try skipping all that. Using Nuget's own package for getting a manifest results in copying the full package stream and then copying the metadata a few times. Try skipping all that. Using Nuget's own package for getting a manifest results in copying the full package stream and then copying the metadata a few times. Try skipping all that. Gets a list of dirs to take for this set of flags. The break-flag means we should not add items from next folders if we add anything from this one. Otherwise they're unioned. Represents an in-memory serializable Nuget package item, much like a is for a file. Identity ctor. Reads manifest from the package file. The package file stream contents in .nupkg format. Has all the data needed to produce a package, but spares the operation itself (mostly due to performance costs on compression and decompression). The path equivalent of the Part URI in the OPC package. . Might be undefined for some of the parts. The path equivalent of the Part URI in the OPC package. . Might be undefined for some of the parts. The path equivalent of the Part URI in the OPC package. . Might be undefined for some of the parts. Defines some of the constants related to handling Nuget packages for subplatforms. Even though all of this functionality is NetFX4-specific and lives in higher assemblies, some of the constants must reside here to be shared. Name of the folder within Nuget package files which we're to use for storing our generic content files by convention. This is not immediately visible to Nuget Core itself and prevents it from adding references to our DLLs from VS projects automatically. Instead, we'd add a custom .Targets file to manage what gets added and how. Package part extension for the jet package metadata objects embedded into a subplatform package. The part contains a structured storage with a SerializedValuesResolver holding the components. The other half of the part local name is the package ID (no version included, for easier cleanup when extracting), and the folder is the main content folder. The standard Nuget Lib folder name. Constants::Lib if we got a reference to Nuget. The standard Nuget Ref folder name (reference assemblies suitable only for project references). The standard Nuget Runtime folder name (assemblies suitable only for running the app at the specific target system). Starting from nuget 2.0, use a file with the special name '_._' to represent an empty folder. Constants::PackageEmptyFileName if we got a reference to Nuget. Name of the Nuget package which is the central/core package of the system, and is basically referenced by nearly every other package. After content files are listed for the package (this means looking in the set folders, and stripping off their paths to make an effective path), checks whether this effective path look like this file could be used as a managed assembly or a managed assembly reference after it's installed. This allows to seamlessly skip content files shipped in subfolders if they're actually managed assemblies, for being inspected for cataloging etc. Also checks the file extension. Gets the effective path of the embedded file in the package, by our convention, only from the Lib or DotFiles folders. If the package follows the DotFiles folder convention, cuts this folder name. Otherwise, takes what Nuget thinks to be the effective path of the file in the Lib folder. The effective path, and whether the file were within the Lib folder in our or Nuget-standard convention. Gets the local name of the package file with the given ID and version. Name of the directory under Packages folder into which the package would be expanded. Loads the package with Nuget. Reads the package and detaches from the instance. Temporary class for v2->v5 NuGet migration; Status reporting item for . The package has already been loaded into memory by some prev request. The package has been loaded from disk from a valid cached copy. The package had to be retrieved from source (e.g. http-downloaded). Same as , but serializable. Converts NuGetVersion to VersionRange which contains only this version. ToBackwardCompatibleVersionRange("11.1.0").ToLegacyShortString() == "[11.1.0]" ToBackwardCompatibleVersionRange("11.1.0.0").ToLegacyShortString() == "[11.1.0.0]" ToBackwardCompatibleVersionRange("11.1.0.1").ToLegacyShortString() == "[11.1.0.1]" With this hack, Manifest can hold some NuGet 5.x-indcompatible versions like 1.0 or 1.0.0.0. The most important effect: such versions will be correctly saved during serialization. Fast-checks if the package has a dependency on package . Adapts a to be exposed as a package file (NuGet v5 only). It is critical to return forward slashes on unix. This class is “anonymous” in that you can create a fully custom implementation without declaring your own derived class. So all these implementations would have the same name of this class, hence “anonymous”. The context which would be passed to each of the functors. This allows to avoid allocating closures for each of the functors, passing all of the closure params thru the . Optional. Implements getting an item by name faster than O(N). If omitted, would do an O(N) search via . Optional. Gets a name of the item. If omitted, will cast to . If omitted and items do not implement , will crash, but only if is also omitted and we have to do a full search by name. Optional. Implements the and operation, if your collection supports adding ready items. Generally, this should only be allowed for immutable items which you can safely co-own. For regular storages, items are added by calling and . supports adding immutable file items as ready items via Add. If omitted, would throw an error hinting to use . A Structured Storage implementation for fast in-memory operations in the "write once, read many" fashion. The format is NOT compatible with any standard readers. Not all possible operations are implemented. The supported operations are: write a newly-created stream (hence, one at a time); read an existing stream (any number). Others might be suboptimal or unavailable. Represents a filesystem tree node for either a storage or a stream (see to tell). The record length in does not include the last field, because it's just a marker. Immediately follwed by the node name (would have a zero char, even if empty), from the record RVA. After that comes the content bytes, long unless it's , at Record RVA + bytes + ( + 1 zero-terminator) chars (!). The special value in the field if the node represents a storage rather than a stream. Note that there can be a storage without any children, yet existing. RVA to the parent. Can be NULL on the root storage, or if the node has been deleted from the tree (=unlinked). Prev sibling, or NULL for the first child or a node without a parent. Next sibling, or NULL for the first child or a node without a parent. First child, or NULL if it's a stream, or a storage with zero children. Last child, or NULL if it's a stream, or a storage with zero children. For a stream node, the content length of that stream. For a storage node, the special value. That's how we tell them. Length of the string, in chars, not including the terminating zero (which must also be written). Not in the structure! Just marks the beginning of the string, UTF-16LE, zero-terminated (ready for use in the runtime). Wraps a native COM storage with the managed interface. Wraps a native COM storage with the managed interface. The lifetime to deterministically close all of the storages and streams. The native storage. If this storage implementation requires name mangling. Internal ctor for substorages. The stream is only opened when calling Open, to avoid keeping the COM reference open for too long. Docfile impl can't have names longer than 31, mangling and table lookup required. ITSS impl can't write nonempty streams. Have to be cloned if opened for writing. // TODO: actually, it's surfaced that ITSS can't actually seek for writing, not write to already-existing streams. Deal with that if such a case surfaces. Means substorages should be opened with instead of . ITSS ignores these flags, but docfiles impl won't open child storages for writing under a readonly storage. COM compound files only handle 31 chars of name length. Have to mangle anything that is longer than that. The full names will be stored in the property storage. Note that the character set is quite permissive, nearly no mangling is needed. Technical limit is 31, but 31-long names will be an additional indication that they have been mangled The original impl. Looks up mangled names right in the property storage stream, writes each new mangling directly to the stream. Gen 2 impl. Stores the single name mangling list in the property storage stream. Reads the stream when first needed, saves (if modified) before closing the storage. Does the lookups and modifications in an in-memory dictionary. NULL until it's actually read from the persisted form, upon the first read/write call. Written when the lifetime ends. A char which separates names in the mangled names table. Must not be valid for file names. Serializes the name mapping before closing the storage, in case there were any modifications. NULLed when closed. Ownership locks on this storage. The open physical storage object. A separate func, to avoid capturing anything in a closure. Path, starting from the root storage we've opened (not including it). Pools opening the physical objects. Does not keep them opened once and forever. Sorted list of open storages. Topmost first, deeper go next. Usually only as large as substorages depth. Close the storages which have no locks. They're kept open for some time to avoid re-opening the same storage with each next call. Opens the storage. Does not add the lock (will be GCed when is called or another storage is opened, so for onstack use only). Creates a new empty storage on a disk file, and fills it with a user callback. Creates a new empty storage, fills it with a user callback, and returns it as a memory stream. Creates a new empty storage on user-supplied COM resizable memory exposed as . Creates a new empty storage on user-supplied COM resizable memory exposed as , and fills it with a user callback. Creates a new empty storage. Opens an already-initialized storage in user-supplied COM resizable memory exposed as , and processes it with a user callback (for just reading and writing). Opens an already-initialized storage in a disk file, and processes it with a user callback (for just reading, or possibly modification). Opens an already-initialized storage in user-supplied COM resizable memory exposed as , and processes it with a user callback (for just reading, or possibly modification). Opens an already-initialized storage in a stream of some sort (for just reading, or possibly modification). Opens an already-initialized storage in user-supplied COM resizable memory exposed as , and processes it with a user callback (for just reading). Opens an already-initialized storage in a stream of some sort, and processes it with a user callback (for just reading, or possibly modification). System-implemented, no compression, 31-char names only. Typical DOC, MSI, XLS, younameit. InfoTech storage implementation from IE4, long filenames, decent compression. Represents a disk folder as a structured storage. A modification to which can serve its streams as in case they are really immutable. If the streams are not immutable, they will not be present in the list. Those streams of this storage which are immutable and can be represented as immutable file items. Might have fewer streams available than the main interface, down to zero, if their bodies cannot be served as immutables. This file item usually efficiently reuses the internal memory of the storage without allocating a copy, which would ordinarily happen when you wrap a regular stream with an immutable file item. With this collection, you can use for existing file items instead of and copying the streams. Regular and do not support . A common basic interface for accessing items with a name. The item name. Means for storing hierarchical data within a single object, similar to COM Structured Storage. Semantially, a storage is like a folder, and a stream is like a file. Child storages, just like subfolders. Streams of this storage, just like child files in a folder. Gets an existing item by its name. Throws an exception if the item is missing. Creates a new item filed under the given unique name. Tries to add the item, if supported by this collection and if not added yet. For most of the storages, adding existing streams and storages is not supported, you should create a new empty storage/stream in the new place and fill with content. is an exception in that you can add existing streams, if supported by the storage. An existing item to add. Error reporting. Whether added OK. Implementations are expected to report to if not OK. Gets an existing item by its name, or Null if there is no item with such a name. Adds a stream with this file item to a storage. If the file item name isn't just a local name and includes components, then substorages are created as needed. If the target storage supports , then the file item might be included with the storage without eagerly copying its immutable content. Copies the contents of one storage into another. Note that a clone of itself is not added under , just the clones of its child storages/streams. Allows an object to support serialization into an . To support deserialization, implement a constructor taking a storage as the single parameter. Populates an with the data needed to serialize the target object. Implements a Structured Storage over the OPC Package, such as a ZIP file package. Creates a new OPC structured storage, writes it into a memory stream, and returns that stream. Creates a new OPC structured storage in a stream. Opens the stream for reading an OPC storage in it. Opens the stream for reading an OPC storage in it. Opens the stream for reading an OPC storage in it. Use this method for getting the relative path for the part. Don't use directly. The inverse to . Serves turning the path into the URI correctly. A set of runtime objects holding all the data, not backed with any media. Compatible with . The logical flags for opening streams, with all the options usually available in CreateFile. Checks if the flags are compatible. Substitutes an empty string when making a valid name. Has characters so that escaping any other names with our algorithm could not match it. Given a candidate stream/storage name, applies escaping so that it fit with . Reverses the effect of . Note that this MUST NOT be applied to strings which didn't undergo because the escaping is only optional; you cannot readily detect if the name were escaped or not. For each storage, it should be decided by its author if names within are freehand outer-world strings and they should be escaped, or not. The default for creating a new stream if the format is not explicitly specified. The preferred format for publicly-exposed files for which in-system performance is not as critical as readability with a wider set of tools. For writing storage files in any of the supported formats, if we're not fixing its format but suppose autodetection. Use this rather than OPC, ITS, DOC etc. Creates a new structured storage, writes it into a memory stream, and returns that stream. The format specification is optional. If omitted, uses . Creates a new structured storage, writes it into the given stream. The format specification is optional. If omitted, uses . Opens a structured storage on an existing stream. The format specification is optional. If omitted, autodetects format by the stream header. Opens a structured storage on an existing stream. The format specification is optional. If omitted, autodetects format by the stream header. Opens a structured storage on an existing stream. Lifetime for using the storage object. Supports autodetection of the format by the storage header, but also allows to specify it manually. Tries to tell which format the storage is in. Must be seekable. Storage impl would need that anyway. A new mode, won't tell apart ZIP-based formats like OPC, for speed. ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC). Based on ZIP. The format of the new docx, xlsx, xps, vsix, nuget, etc files. A successor for COM Compound Files. Uses the managed implementation from , which has some impact due to the intermediate data storages in .NET Isolated Storage. A native implementation is available, but it requires newer Windows systems and is thus not used. Viewer: any ZIP viewer. The classical implementation of the COM Structured Storage, the COM Compound Files binary format, aka DocFile format. The format of the doc, xls, msi, etc. Uses the Windows built-in COM implementation over . Technically, does not support paths longer than 31 char in utf16, so external long names support has been layered over it. Viewer: FAR, or any other docfile viewer. The InfoTech Storage System, as introduced with IE4 and used for CHM (compiled HTML help) and ITS file formats. Exposes the same COM Structured Storage interface, supports long names internally and has decent compression. Viewer: FAR, or any other CHM file viewer like HelpwareFAR. Plain zip file Implements a Structured Storage over ZIP file. ASCII range, XML-safe and printable-safe and filename-safe. Creates a new OPC structured storage in a stream. Opens the stream for reading an OPC storage in it. Opens the stream for reading a ZIP storage in it. Opens the stream for reading an OPC storage in it. OPC storages is a different class. Now, for speed, we won't probe for them when detecting format, but rather open as ZIP and catch if we missed. They aren't used much, really. When writing new content, gets kept here until we commit to the ZIP. For if we do a full commit after each write, it gets to rebuild the whole ZIP on each iteration, and feels O(n2) on writes. And if we submit it to ZIP and do not commit, it won't return the newly-submitted streams when opening entries. So we got to keep them in own cache for a while. The originating ZIP entry of this stream, if created over an unmodified stream from the loaded storage. Keeps the index (for fast reading) and the entry transport name. When opening by entry, only uses the index when it still matches the name, ie is a safe bet. For modified or newly-created entries, we keep their streams until we are ready to commit the archive, so this will be NULL. Set to an entry if this node has been created from a real zip directory entry, or to NULL if it's been created because some child entry exists for a dir/file. Used to delete the entry. An adapter from s world into the world: if your provider can give a stream under a lifetime, but your consumer wants a stream that it will dispose. Gives you the lifetime under which you can get the stream from provider. Terminates this lifetime when your consumer disposes of this object. Prevents the original stream which you've received under the lifetime from being disposed of when the consumer disposes of this object (whether to dispose of that stream is up to the producer who's given the lifetime). Uses methods from base class for equality comparison: the object equality is checked bitwise on the reference value (or value type body), and the hash code is produced from the sync table entry. The object contents is not inspected (on reference types), and object's methods are not called (in either case). Extremely recommended for delegates, because normally they should only match themselves, and comparing or hashing a delegate is an expensive operation in modern NetFX. Creates temporary folder in specified parent folder. Parent folder must exist. If parent folder is omitted %temp% is used Creates temporary folder in specified parent folder. Parent folder must exist. If parent folder is omitted %temp% is used Creates temporary folder in specified parent folder. Parent folder must exist. If parent folder is omitted %temp% is used Use folder as temporary and clean-up on dispose Must be used with using (new TestPresentationMap()) {...} idiom To suppress calculation of presentation in /> Uses one character to represent new line. Uses one character to represent new line. Gets the default target netfx version for the managed projects in the solution, unless overridden by their specific needs (like supporting newer VS versions). This is the default Nuget package content extraction framework. Make a clone of the URI where OriginalString is a previous full url string Wraps with URI to access thru JetBrains Cache Redirector if applicable. Implementation of RFC 4122 - A Universally Unique Identifier (UUID) URN Namespace. Creates a version 5 name-based UUID. The namespace UUID. The value. The UUID for the given namespace and value. and are taken from this version, and and are set to -1. The resulting version object has only two components defined, and renders as x.y. and are taken from this version, and and are set to 0. The resulting version object has all four components defined, and renders as x.y.0.0. Returns version with trailing zeroes replaced with -1 Version to update Version with no trailing zeroes Version number based on date and time in its two last components. Version number based on date and time in its two last components. The default assembly version for such assemblies that have not been assigned a manual version. Currently, fixed to 777, 0. The default subplatform package version for such subplatforms that have not been assigned a manual version. Currently, wavenumber, 0 — when the new wavenumbers are 182+. An util class to interact with Windows Explorer Open Windows Explorer with active selection on item (either file or folder) Open Windows Explorer with active selection on item (either file or folder) Opens Windows Explorer in specific folder and select one or several items in it. full path to the directory Full paths to items to select. Must be located in directory, provided by When null or empty without selection will be opened. Open folder without selection in Windows Explorer. Open folder without selection in Windows Explorer. When path is file - select it, otherwise - open it One executable, one service One executable, many services One svchost.exe, many services from DLLs Asserts that the reader is currently at the element with the specific name. Advances before throwing to avoid endless child loops. Asserts that the reader is currently at the element with the specific name. Advances before throwing to avoid endless child loops. Makes sure the reader is at the same node depth after executing the nested code as before running it. Throws if the nested code pops out of the orignal level. Note: this is a lightweight alternative to . Use the latter to get maximum stability. After executing the nested code, makes sure the depth level is that of the parent of the orignial element (one depth level up). Throws if the nested code pops out of the limiting level. Note: this is a lightweight alternative to . Use the latter to get maximum stability. Creates a new reader that scopes the current element only. cannot proceed past the current element on its reader, as the reader will report end-of-stream. After this function exits, the outer is positioned on the next node after the element it was called on. The reader of the is initially positioned on the same element. Enters the current element, scans through all of its children, and calls for each of the first-level child elements. Must be called on an element (use if needed). must do at least one read operation on the , otherwise the reader could enter an endless loop. It is not necessary to read all of the child content, or return to the original depth level. On the current depth level, scans through all of the elements, and calls for each of the same-level elements. must do at least one read operation on the , otherwise the reader could enter an endless loop. It is not necessary to read all of the element content, or return to the original depth level. Reads up to the opening tag of an element on the same level as the current reader position. Returns whether such an element could be found. Reads up to the opening tag of an element on the specified depth level. Returns whether such an element could be found. Impl for and . Creates a reader over the stream. Does not close the stream by default. Creates a reader over the stream. Does not close the stream by default. Creates a reader over the stream. Does not close the stream by default. Creates a reader over the stream. Does not close the stream by default. Adds the current line-column of the XML parser position (if this information is available on the parser). Adds the current line-column of the XML parser position (if this information is available on the parser). Logs disposable activities to a temporary file (%TEMP%\ReSharper_ActivityCollector-[time-and-random-stuff].txt) Activity is with name. Basic usage pattern: var activity = ActivityCollector.GetEndpoint().StartActivity(new Key("activity name")) [do some stuff] activity.Dispose() After dispose call thread id, activity name, start time and end time will be written to log. Linear anchoring constants. Left or top, anchored outside the area. Left or top, anchored inside the area. Center or middle, anchored inside the area. Preferably, in the center. Right or bottom, anchored inside the area. Right or bottom, anchored outside the area. Describes the anchoring in two dimensions. Backup for . Backup for . Backup for . Backup for . Backup for . The raw value combining both vertical and horizontal anchoring. Initializes from a raw value. Initializes the instance. Gets the list of anchoring to place the entity aside the anchor, preferably, left, right, then bottom and top. The content is centered aside the anchor. Gets the list of anchoring to place the entity aside the anchor, preferably, left, right, then bottom and top. The content is not centered against the anchor, prefers hanging to the bottom or to the right. Gets the list of side-anchoring dispositions in descending order of preferrability. The preferred side is bottom, then top, then right and left. Gets the list of side-anchoring dispositions in descending order of preferrability. The preferred side is right, then left. That's all. Gets the list of side-anchoring dispositions in descending order of preferrability. The preferred side is top, sides top to bottom, then bottom. Gets the list of side-anchoring dispositions in descending order of preferrability. The preferred side is top, then bottom, then left and right. Gets or sets the hotizontal component of the anchoring. Gets whether the anchoring is inside the rect against both dimensions. Gets or sets the hotizontal component of the anchoring. Checks whether the given is one of the Far— anchorings, namely, or . Checks whether the given is one of the Near— anchorings, namely, or . Creates an array consisting of just one item. Returns a that represents the current . A that represents the current . 2 Mode how to treat ExpectedBackgroundColorHint property (Legacy mode) Render will tune foreground slightly to preserve original color as far as possible. Use it when you need to preserve your foreground color primarily but you need to be able to read it. Other words hint for the engine to just makes sure the foreground color is visible over the background color Render will try to obey maximum contrast. Use it when you need good text experience (perception) no matter where it will render Checks the given HRESULT, and throws an exception if it's a failure one (). The comment is used in case of the failure only. Note: located here because we do not have ExtensionAttribute in Interop.WinAPI. In there, use . Checks the given HRESULT, and throws an exception if it's a failure one (). The comment is used in case of the failure only. Note: located here because we do not have ExtensionAttribute in Interop.WinAPI. In there, use . Checks the given HRESULT, and throws an exception if it's a failure one (). The comment is used in case of the failure only. Note: located here because we do not have ExtensionAttribute in Interop.WinAPI. In there, use . Checks the given HRESULT, and throws an exception if it's a failure one (). The comment is used in case of the failure only. Note: located here because we do not have ExtensionAttribute in Interop.WinAPI. In there, use . Checks the given HRESULT, and throws an exception if it's a failure one (). The comment is used in case of the failure only. Note: located here because we do not have ExtensionAttribute in Interop.WinAPI. In there, use . The FAILED WinAPI Macro. The SUCCEEDED WinAPI Macro. Applies the . Specifies rendering context for the and presentable item rederers. . , lazy-init. Let the defaults apply to all the static fields before we create an instance, so lazy-init on first use. . Creates an empty instance initialized with the default values. Gets or sets a custom override for the font in which the text will be rendered. By default, NULL. This means that the renderer would use whatever font is considered default for the place it's rendered (message font, menu font, tooltip font, code font, etc etc). Gets or sets the optional override of the font style for rendering the text. If set, overrides both the style of the and local strings. Gets or sets the neutral foreground color setting. Does not override local colors, applies only to those strings whose color is set to NULL. May be NULL, in which case the renderer will choose the default color, most likely, ControlText. Gets or sets the neutral background color setting. Does not override local colors, applies only to those strings whose color is set to NULL. May be NULL, in which case the renderer will choose the default color, most likely, . Gets or sets the hint for the expected background color under the transparently rendered rich text string. Unlike and , this color does not paint on screen as the opaque background under rich text. This is a hint for the engine which makes sure the foreground color is visible over the background color. When and are explicitly defined, they allow to adjust the foreground color as needed to be distinct. They don't apply when text has to be rendered over a transparent background (e.g. over a gradient or some image). If you know the approximate color of the background (e.g. gradient mid-color) and want the foreground color to be forced readable, but cannot set the text background to a flat value — assign the approximage color as the expected background color hint. Gets or sets how to treat the hint for the expected background color Gets or sets the string trimming to be used when rendering the string. Gets or sets the mnemonic treatment (ampersand characters) to be used when rendering the string. Gets or sets the color that overrides the local foreground color of all the strings, unless set to NULL. Takes precedence over . Gets or sets the color that overrides the local background color of all the strings, unless set to NULL. Takes precedence over . Gets or sets the effect style that overrides the local settings of the strings, unless set to , in which case the local on the strings settings are used. Gets or sets the effect color that overrides the local setting on the strings, unless set to NULL. Works independently of . Gets or sets a flag that defines the rendering engine to be used by text renderers. Gets the empty rendering parameters that do not override anything and supply the default UI font. This instance is read-only and cannot be modified. Gets the default text rendering method. Gets whether the instance is readonly and its fields cannot be changed. Dumps the object state in the XAML format. Sets all the colors to be NULL. Seals the instance by setting it into the read-only mode, see . Returns a that represents the current . A that represents the current . 2 Specifies style information applied to a font represented by , in a framework-independent manner. Things like strikeout or underline are not directly represented by a font, but by text rendering (such as ), they cannot be mapped directly into an Avalon font, so they are not included here. Represents a formatted string that is a part of . Gets the text of this part. Gets or sets the string style Gets or sets the starting offset. Gets or sets the length. Gets the parent text. Creates a new instance. String part offset. String part length. The style. The parent richtext block. is null. The range specified by and does not fall within the parent string. Overrides the local text style with those properties of the ' text style that are set to override. Overrides the local font style with settings from the rendering aspect. Checks whether the rich text substring settings are valid against the parent rich text object. Dumps the object. Formatting flags that define the text rendering style. No flags set. Render the ellipsis character when the string gets truncated. Render the mnemonic by underlining the next character after the “&” char. If not set, the ampersands are rendered “as is”. All the flags. Represents a formatted text block (i.e., actually, sequence of instances). Verbose trace. Formatting for the text parts. Must not be Null. Allows rich text renderer to cache custom data on the instance. Typically, this is the cached size value for the GDI+ painter. Plus, a hash for the and DPI for which the cache is valid. Plain text of the rich text. Must not be Null. Creates a new rich text string. Text content. The style to apply to the plain text. Creates a new rich text string. Does not apply any formatting to the plain text, uses the value. Text content. Creates a new empty non-styled rich text string. Same as . The internal cloning ctor. Gets an empty rich text string. Same as This cannot be made a public field, nor can it return the same instance for the sake of optimization, because it's not immutable and any modification will affect the subsequent uses Returns common background color. If colors are different in different parts returns NULL. Returns common foreground color. If colors are different in different parts returns NULL. Gets whether the string contained in this rich text is empty. Gets total length of the text in characters. Gets or sets the underlying text as an unformatted string. Checks whether the given rich text instance is null or represents an empty string. Appends a part with a custom style to the text. The part to add. The style of the part to add. Inserts a string into the rich text at the specified offset. The string uses the default styles. The offset at which to insert the string. The string to insert. Appends a string to the text. Uses the default style. The character to add. Appends a string to the text. The character to add. Style of the char Appends the specified char specified number of times. The character to add several times. The number of times to add the character. Appends a string to the text, then appends a newline. The string to append Appends a string to the text with a given style, then appends a newline. The string to append The style of the part to add. Appends a new line to the rich text. Appends a string to the text. Uses the default style. The part to add. Appends a string to the text. Uses the style of the trailing character. The part to add. Appends a interpolated string to the rich text. Preserves the rich text in the interpolated holes. Literal parts are formatted with default text style. Appends a interpolated string to the rich text. Preserves the rich text in the interpolated holes. Literal parts are formatted with default text style. Appends line break after. Appends some rich text to the current one. The rich text to append. Removes range of character from the rich text and returns self Start offset of the range to remove Length of the range to remove Changed self Removes range of character from the rich text and returns self Range of characters to remove Changed self Performs consistency checks over the rich text. Clears the rich text string. Returns a that represents the current . A that represents the current . Dumps the object. Gets a readonly collection of the formatting elements. Prepends a part with a custom style to the text. The part to add. The style of the part to add. Prepends a string to the text. Uses the default style. The part to add. Prepends a string to the text. Uses the style of the leading character. The part to add. Appends one rich text to another The rich text to append Sets the new background color for the given range. Don't set background color to because it would prevent painters from providing the neutral color. Sets the new background color for the whole text. Don't set background color to because it would prevent painters from providing the neutral color. Sets new colors for the whole text. Don't set background color to because it would prevent painters from providing the neutral color. Foreground color to set. Background color to set. Sets the new foreground and background colors for the given range. Don't set background color to because it would prevent painters from providing the neutral color. Sets the new foreground color for the whole text. Sets the new foreground color for the given range. Sets the new foreground color for the whole text. Sets the new foreground color for the given range. Sets new style to a specified part of the text The style to set Start offset of the block Block length startOffset is invalid in current string length is invalid starting with specified startOffset Sets new font style to a specified part of the text The font style to set Start offset of the block Block length startOffset is invalid in current string length is invalid starting with specified startOffset Sets new effect style to a specified part of the text. The effect style to set Start offset of the block Block length Optionally, changes the color of the effect. startOffset is invalid in current string length is invalid starting with specified startOffset Applies a new (font style and colors) to the whole rich text string. The style to apply. Sets new effect to a specified part of the text The effect style to set The effect color to set Start offset of the block Block length startOffset is invalid in current string length is invalid starting with specified startOffset Sets new effect to a specified part of the text The effect style to set The effect color to set Splits rich text before the specified offset so that the first part's length is equal to the . The offset to split the text at. An array consisting of the two resulting parts. The array length is always equal to 2, even if either part is empty. Retrieves a substring from this instance. The substring starts at a specified character position and has a specified length. The zero-based starting character position of a substring in this instance. The number of characters in the substring. A RichText that is equivalent to the substring of length that begins at in this instance, or if is equal to the length of this instance and is zero. Retrieves a substring from this instance. The substring starts at a specified character position and lasts to its end. The zero-based starting character position of a substring in this instance. A RichText that is equivalent to the substring that begins at in this instance, or if is equal to the length of this instance Trims the leading and trailing characters from the rich text string. Warning: a constant function, would not modify the instance! An array of Unicode characters to remove or Null. Trims the leading and trailing characters from the rich text string. Warning: a constant function, would not modify the instance! Checks whether Unicode character needs to be removed. If null then is used Trims the trailing characters from the rich text string. Warning: a constant function, would not modify the instance! An array of Unicode characters to remove or Null. Trims the trailing characters from the rich text string. Warning: a constant function, would not modify the instance! Checks whether Unicode character needs to be removed. If null then is used Trims the trailing characters from the rich text string, modifying the current instance. Helps to avoid unnecessary allocations caused by the code patterns like result = result.TrimEnd(); Checks whether Unicode character needs to be removed. If null then is used. Trims the leading characters from the rich text string. Warning: a constant function, would not modify the instance! An array of Unicode characters to remove or Null. Trims the leading characters from the rich text string. Warning: a constant function, would not modify the instance! Checks whether Unicode character needs to be removed. If null then is used Breaks a part into two parts at the given local offset, which is relative to the part. Replaces char a with b without formatting loose Char Char Replaces string while preserving formatting. Throws if replaced substring belongs to more than a single formatted part. text to replace with Gets the list of parts that fall within the given range. The rich strings on the range boundaries are split, if needed. Gets the underlying text as an unformatted string. Gets plain string representation of rich text, plus string part marks. Extra decoration after a part mark String representation Gets plain string representation of rich text, plus string part marks. Rich text comparer mainly exists to enable stable-ordering rich texts. The main ordering property is the plain text of this item. Then, all possible properties of the parts are somehow considered. Rich text comparer mainly exists to enable stable-ordering rich texts. The main ordering property is the plain text of this item. Then, all possible properties of the parts are somehow considered. Like , but for RichText.
NOTE: do NOT make an instance method of an ext method because RichText instance methods are mutating the object state! This one is pure and should thus bei n static call syntax to avoid being misguiding. The version of 'string.Format' for 'RichText'. Handles 'RichText' as arguments, preserves the formatting. The version of 'string.Format' for 'RichText'. Handles 'RichText' as arguments, preserves the formatting. Defines the possible rendering methods to be used when rendering text strings. Use GDI+ rendering via the class (.NET default). Use GDI rendering via the HDC device contexts and User32Dll.DrawText function calls. Represents a block (possibly multiline) of rich text. Lines of rich text block Gets the rich text lines of the block. Gets or sets the parameters. Gets or sets the rich text block as a whole rich text fragment. Gets or sets the plaintext representation of the rich text block. The setter creates a number of unformatted rich text lines. Dumps the object. Gets plain string representation of rich text, plus string part marks. Optional extra decoration after a part mark String representation Returns a that represents the current . A that represents the current . 2 Structure for setting parameters for rich text blocks Structure for setting parameters for rich text blocks Dumps the object. Returns a that represents the current . A that represents the current . 2 Similar to WinForms' ContentAlignment, but without depending on WinForms DLLs. Content is vertically aligned at the top, and horizontally aligned on the left. Content is vertically aligned at the top, and horizontally aligned at the center. Content is vertically aligned at the top, and horizontally aligned on the right. Content is vertically aligned in the middle, and horizontally aligned on the left. Content is vertically aligned in the middle, and horizontally aligned at the center. Content is vertically aligned in the middle, and horizontally aligned on the right. Content is vertically aligned at the bottom, and horizontally aligned on the left. Content is vertically aligned at the bottom, and horizontally aligned at the center. Content is vertically aligned at the bottom, and horizontally aligned on the right. Gets whether the rich text object is empty (Null or has no text). Gets whether the rich text object is empty (Null or has no text). Represents style of text block Enumerates different text drawing effects No effects. Underline with a straight line. Underline with a gay line. Strike out with a straight line. Font style Foreground color Background color Effect to use Effect color Defines a text style. This constructor defines style with no effects. The font style to use Foreground color Background color Defines a text style. This constructor defines style with no effects. The font style to use Foreground color Defines a text style. The font style to use Foreground color Background color Effect to use Effect color to use R# highlighting attribute id Defines a text style. This constructor defines style with no effects and regular style of the text. Foreground color Background color Defines a text style that has no properties except AttributeId The R# attribute id that can later be used to determine other properties Creates a style that has only background color specified. Creates a style that has only foreground color specified. Gets or sets font style Gets or sets the foreground color. NULL means “Don't care, renderer should specify, if not, use ”. Gets or sets the background color. NULL means “Don't care, renderer should specify, if not, use ”. Gets or sets used effect Gets or sets the effect color. NULL means the will be used. R# attribute id that can be used to determine other properties of the style Gets the default text style. Gets the hidden text style. See . See . Dumps the object. Returns a that represents the current . A that represents the current . 2 Mostly for stable sorting the owning object. Progress indicator that combined multiple indicators Progress indicator that combined multiple indicators and support live add/remove indicator .net core for windows 8 and 8.1 The main framework identifier for .NET Core applications Returns an ordered representation of the collection, the order defined by the . Item type. Collection of items without any order implied. Time to work. Comparer setting up the order. Filtering function. If True, adding an item that is already present in the list is not allowed (unless , an exception is thrown). If False, the duplicate item is just added to the list. Use it to filter small-sized list events when filter condition is live (IProperty) WARNING!!! Horribly ineffective, rewrite it to use on big lists A list that fires events when items are added or removed. List values type. (yes, nongeneric) was added to support WPF scenarios eg XAML [de]serialization. is also here for WPF support. The universal constructor. Constructs the list over some list-like backing storage. Specifies whether items in the list must be unique (note: this option is performance-costly). An unique identifier for the list, to tell it apart in data flow chains. If callstack annotation is on, will appear on callstacks when collection is modified. Thus, only compile-time-defined values should be used, to avoid spawning too many dynamic methods at runtime. The underlying collection, all the operations will be relayed to it. If True, adding an item that is already present in the list is not allowed (unless , an exception is thrown). If False, the duplicate item is just added to the list. Logging facility optional override. Use overloads without lifetime. Constructs the list over some list-like backing storage. Specifies whether items in the list must be unique (note: this option is performance-costly). An unique identifier for the list, to tell it apart in data flow chains. If callstack annotation is on, will appear on callstacks when collection is modified. Thus, only compile-time-defined values should be used, to avoid spawning too many dynamic methods at runtime. The underlying collection, all the operations will be relayed to it. If True, adding an item that is already present in the list is not allowed (unless , an exception is thrown). If False, the duplicate item is just added to the list. Constructs the list over some list-like backing storage. Specifies whether items in the list must be unique (note: this option is performance-costly). An unique identifier for the list, to tell it apart in data flow chains. If callstack annotation is on, will appear on callstacks when collection is modified. Thus, only compile-time-defined values should be used, to avoid spawning too many dynamic methods at runtime. The underlying collection, all the operations will be relayed to it. If True, adding an item that is already present in the list is not allowed (unless , an exception is thrown). If False, the duplicate item is just added to the list. Use overloads without lifetime. Creates a new list that does not allow duplicate items, with a simple list storage inside. An unique identifier for the list, to tell it apart in data flow chains. If callstack annotation is on, will appear on callstacks when collection is modified. Thus, only compile-time-defined values should be used, to avoid spawning too many dynamic methods at runtime. Use overloads without lifetime. Creates a new list with a simple list storage inside. An unique identifier for the list, to tell it apart in data flow chains. If callstack annotation is on, will appear on callstacks when collection is modified. Thus, only compile-time-defined values should be used, to avoid spawning too many dynamic methods at runtime. If True, adding an item that is already present in the list is not allowed (unless , an exception is thrown). If False, the duplicate item is just added to the list. Creates a new list with a simple list storage inside. An unique identifier for the list, to tell it apart in data flow chains. If callstack annotation is on, will appear on callstacks when collection is modified. Thus, only compile-time-defined values should be used, to avoid spawning too many dynamic methods at runtime. If True, adding an item that is already present in the list is not allowed (unless , an exception is thrown). If False, the duplicate item is just added to the list. Use overloads without lifetime. Creates a new list that allows duplicate items, with a simple storage inside. Creates a new list that does not allow duplicate items, with a storage inside. Fires the event. Fires the event. Returns whether the operation has been cancelled. One of the core methods that implement the actual List functionality. DO NOT call from collection impl because to enable Call Stack Annotation all calls to this method MUST go thru . Either a real index (which is not thread-safe unless it's 0), or -1 which means “add to end” and is a special case for the thread-safe method. One of the core methods that implement the actual List functionality. DO NOT call from collection impl because to enable Call Stack Annotation all calls to this method MUST go thru . Acknowledges the handler. Acknowledges the handler. Cannot be merged with because the iteration should go in the reverse order. Called when someone attempts to sink the signal. Acknowledges the handler. One of the core methods that implement the actual functionality. Gets or sets the element at the specified index. The element at the specified index. The zero-based index of the element to get or set. index is not a valid index in the . The property is set and the is read-only. Determines the index of a specific item in the . The index of item if found in the list; otherwise, -1. The object to locate in the . Inserts an item to the at the specified index. The object to insert into the . The zero-based index at which item should be inserted. The is read-only. index is not a valid index in the . Attempts to insert an item to the list at the specified index. The object to insert into the list. The zero-based index at which item should be inserted. An optional cookie that comes along with the notification events data. Whether the item was added to the collection. An addition can be cancelled by the duplicates merger or the before-added handlers. A universal method for modifications on the collection. Useful for data flow between the collections, when signal handler is pumping into another collection. Whether to add or remove the item. The item to add or remove. The index at which the modification should occur. The optional modification cookie. Success code. A universal method for modifications on the collection. Useful for data flow between the collections, when signal handler is pumping into another collection. Whether to add or remove the item. A function that is called only when doing the operation and produces the new item to be added to the list. This allows to create a new item when pumping from one collection to another with creating the wrappers simultaneously. The index at which the modification should occur. The optional modification cookie. Success code. Removes the item at the specified index. The zero-based index of the item to remove. The is read-only. index is not a valid index in the . Attempts to remove an item at the specified index from the list. The zero-based index of the item to remove. An optional cookie that comes along with the notification events data. Whether the item was removed from the collection. A removal may fail either if the item is missing from the collection, or the before-removed handlers have cancelled the operation. Fires when an item is added or removed to your view on the collection. Throwing an exception does not prevent the item from being added or other handlers from being called. The event supports acknowledgement, which means that when you sink the event, all the items currently in collection come into your view on the collection, so the add is fired for each. Similarly, remove is fired when you unsink and all the elements go away from your view on the collection. Fires before an item is added or removed. To prevent the add/remove operation, set to True (decline the operation silently) or throw an exception (the exception is let out to the caller). After the first handler to cancel the operation, the remaining handlers may not be called. No are guaranteed to be executed if the operation is cancelled. Call Stack Annotation helpers. When something changes, presents the details about the change. The identity of the item that changes. The old and new values for the item. Gets the name of the entity that has changed, eg property name. Gets the new value. Gets the old value. Creates that passively reflect the Registry values. Note that currently they do not track Registry changes. Creates a property that's passively mirrored into Registry (does not listen to Registry changes). Note that the Registry key is not kept open between the read/write sessions. Value type. The root key, eg . The relative path from the root key to the key that contains the data we're binding to. Name of the data. Null for the default value of the key. Default value for the data when reading it from Registry initially, in case it's missing. A cyclic buffer, like a queue for bytes, but optimized for byte block operations. For reading and writing, use the provided interface. End of used data range in , non-inclusive (points after the last used byte, might be equal to storage length). Might be below , in which case the data loops around the buffer end. Starts of used data range in . The cyclic storage. Gets or sets the capacity of the buffer storage, which is the maximum it can hold without growing, which growing could be prohibited by setting the . Gets the stream for writing to the buffer. Gets the stream for reading from the buffer. Implements reading from the stream (and also peeking at the data without spending the stored bytes). Target for reading (as in ). Target for reading (as in ). Target for reading (as in ). Behavior when running out of buffer. Spend the read bytes and decrease the number of bytes available in the storage. If False, just peeks at the stored data without modifying the storage. The number of bytes actually read. Implements writing to the stream. Source for writing (as in ). Source for writing (as in ). Source for writing (as in ). Behavior when running out of buffer. The number of bytes actually written. Adds an item to the . The object to add to the . The is read-only. Removes all items from the . The is read-only. Determines whether the contains a specific value. true if is found in the ; otherwise, false. The object to locate in the . Copies the elements of the to an , starting at a particular index. The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. The zero-based index in at which copying begins. is null. is less than 0. is multidimensional.-or- is equal to or greater than the length of .-or-The number of elements in the source is greater than the available space from to the end of the destination .-or-Type T cannot be cast automatically to the type of the destination . Returns an enumerator that iterates through the collection. A that can be used to iterate through the collection. 1 Removes the first occurrence of a specific object from the . true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . The object to remove from the . The is read-only. Returns an enumerator that iterates through a collection. An object that can be used to iterate through the collection. 2 Gets the number of elements contained in the . The number of elements contained in the . Gets a value indicating whether the is read-only. true if the is read-only; otherwise, false. for the . When overridden in a derived class, clears all buffers for this stream and causes any buffered data to be written to the underlying device. An I/O error occurs. 2 When overridden in a derived class, reads a sequence of bytes from the current 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. An array of bytes. When this method returns, the buffer contains the specified byte array with the values between and ( + - 1) replaced by the bytes read from the current source. The zero-based byte offset in at which to begin storing the data read from the current stream. The maximum number of bytes to be read from the current stream. The sum of and is larger than the buffer length. is null. or is negative. An I/O error occurs. The stream does not support reading. Methods were called after the stream was closed. 1 When overridden in a derived class, sets the position within the current stream. The new position within the current stream. A byte offset relative to the parameter. A value of type indicating the reference point used to obtain the new position. An I/O error occurs. The stream does not support seeking, such as if the stream is constructed from a pipe or console output. Methods were called after the stream was closed. 1 When overridden in a derived class, sets the length of the current stream. The desired length of the current stream in bytes. An I/O error occurs. The stream does not support both writing and seeking, such as if the stream is constructed from a pipe or console output. Methods were called after the stream was closed. 2 When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written. An array of bytes. This method copies bytes from to the current stream. The zero-based byte offset in at which to begin copying bytes to the current stream. The number of bytes to be written to the current stream. The sum of and is greater than the buffer length. is null. or is negative. An I/O error occurs. The stream does not support writing. Methods were called after the stream was closed. 1 When overridden in a derived class, gets a value indicating whether the current stream supports reading. true if the stream supports reading; otherwise, false. 1 When overridden in a derived class, gets a value indicating whether the current stream supports seeking. true if the stream supports seeking; otherwise, false. 1 When overridden in a derived class, gets a value indicating whether the current stream supports writing. true if the stream supports writing; otherwise, false. 1 When overridden in a derived class, gets the length in bytes of the stream. A long value representing the length of the stream in bytes. A class derived from Stream does not support seeking. Methods were called after the stream was closed. 1 When overridden in a derived class, gets or sets the position within the current stream. The current position within the stream. An I/O error occurs. The stream does not support seeking. Methods were called after the stream was closed. 1 When there is no more room for writing, grows the storage. When there is no more room for writing, throws an exception. for the . When overridden in a derived class, clears all buffers for this stream and causes any buffered data to be written to the underlying device. An I/O error occurs. 2 When overridden in a derived class, reads a sequence of bytes from the current 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. An array of bytes. When this method returns, the buffer contains the specified byte array with the values between and ( + - 1) replaced by the bytes read from the current source. The zero-based byte offset in at which to begin storing the data read from the current stream. The maximum number of bytes to be read from the current stream. The sum of and is larger than the buffer length. is null. or is negative. An I/O error occurs. The stream does not support reading. Methods were called after the stream was closed. 1 When overridden in a derived class, sets the position within the current stream. The new position within the current stream. A byte offset relative to the parameter. A value of type indicating the reference point used to obtain the new position. An I/O error occurs. The stream does not support seeking, such as if the stream is constructed from a pipe or console output. Methods were called after the stream was closed. 1 When overridden in a derived class, sets the length of the current stream. The desired length of the current stream in bytes. An I/O error occurs. The stream does not support both writing and seeking, such as if the stream is constructed from a pipe or console output. Methods were called after the stream was closed. 2 When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written. An array of bytes. This method copies bytes from to the current stream. The zero-based byte offset in at which to begin copying bytes to the current stream. The number of bytes to be written to the current stream. The sum of and is greater than the buffer length. is null. or is negative. An I/O error occurs. The stream does not support writing. Methods were called after the stream was closed. 1 When overridden in a derived class, gets a value indicating whether the current stream supports reading. true if the stream supports reading; otherwise, false. 1 When overridden in a derived class, gets a value indicating whether the current stream supports seeking. true if the stream supports seeking; otherwise, false. 1 When overridden in a derived class, gets a value indicating whether the current stream supports writing. true if the stream supports writing; otherwise, false. 1 When overridden in a derived class, gets the length in bytes of the stream. A long value representing the length of the stream in bytes. A class derived from Stream does not support seeking. Methods were called after the stream was closed. 1 When overridden in a derived class, gets or sets the position within the current stream. The current position within the stream. An I/O error occurs. The stream does not support seeking. Methods were called after the stream was closed. 1 When there are no more bytes to read, returns the reduced read-bytes count. When there are no more bytes to read, throws an exception. Class that implements . The implementation of . A reference to a package. Gets the general package identifier. The general package identifier. Gets the version of the package. The version of the package. Gets the target process architecture of the package. The target process architecture of the package. Gets the language and optional region identifier. The language and optional region identifier. Gets the build branch of the package. The build branch of the package. Gets the type of the package. The type of the package. Gets the unique identifier consisting of all defined tokens. The unique identifier consisting of all defined tokens. Gets a value indicating whether the package refers to an external extension. A value indicating whether the package refers to an external extension. Information about an instance of a product. Gets the instance identifier (should match the name of the parent instance directory). The instance identifier. Gets the local date and time when the installation was originally installed. The local date and time when the installation was originally installed. Gets the unique name of the installation, often indicating the branch and other information used for telemetry. The unique name of the installation, often indicating the branch and other information used for telemetry. Gets the path to the installation root of the product. The path to the installation root of the product. Gets the version of the product installed in this instance. The version of the product installed in this instance. Gets the display name (title) of the product installed in this instance. The LCID for the display name. The display name (title) of the product installed in this instance. Gets the description of the product installed in this instance. The LCID for the description. The description of the product installed in this instance. Resolves the optional relative path to the root path of the instance. A relative path within the instance to resolve, or NULL to get the root path. The full path to the optional relative path within the instance. If the relative path is NULL, the root path will always terminate in a backslash. Gets the state of the instance. The state of the instance. Gets an array of package references registered to the instance. An array of package references registered to the instance. Gets a package reference to the product registered to the instance A package reference to the product registered to the instance. This may be null if does not return . Gets the relative path to the product application, if available. The relative path to the product application, if available. Gets the error state of the instance, if available. The error state of the instance, if available. Gets a value indicating whether the instance can be launched. Whether the instance can be launched. An instance could have had errors during install but still be launched. Some features may not work correctly, but others will. Gets a value indicating whether the instance is complete. Whether the instance is complete. An instance is complete if it had no errors during install, resume, or repair. Gets product-specific properties. An of product-specific properties, or null if no properties are defined. Gets the directory path to the setup engine that installed the instance. The directory path to the setup engine that installed the instance. Information about an instance of a product. Gets the instance identifier (should match the name of the parent instance directory). The instance identifier. Gets the local date and time when the installation was originally installed. The local date and time when the installation was originally installed. Gets the unique name of the installation, often indicating the branch and other information used for telemetry. The unique name of the installation, often indicating the branch and other information used for telemetry. Gets the path to the installation root of the product. The path to the installation root of the product. Gets the version of the product installed in this instance. The version of the product installed in this instance. Gets the display name (title) of the product installed in this instance. The LCID for the display name. The display name (title) of the product installed in this instance. Gets the description of the product installed in this instance. The LCID for the description. The description of the product installed in this instance. Resolves the optional relative path to the root path of the instance. A relative path within the instance to resolve, or NULL to get the root path. The full path to the optional relative path within the instance. If the relative path is NULL, the root path will always terminate in a backslash. Helper functions. Parses a dotted quad version string into a 64-bit unsigned integer. The dotted quad version string to parse, e.g. 1.2.3.4. A 64-bit unsigned integer representing the version. You can compare this to other versions. Parses a dotted quad version string into a 64-bit unsigned integer. The string containing 1 or 2 dotted quad version strings to parse, e.g. [1.0,) that means 1.0.0.0 or newer. A 64-bit unsigned integer representing the minimum version, which may be 0. You can compare this to other versions. A 64-bit unsigned integer representing the maximum version, which may be MAXULONGLONG. You can compare this to other versions. Gets information about product instances set up on the machine. Enumerates all completed product instances installed. An enumeration of installed product instances. Gets the instance for the current process path. The instance for the current process path. Gets the instance for the given path. Path used to determine instance The instance for the given path. Enumerates all product instances. An enumeration of all product instances. Gets information about product instances set up on the machine. Enumerates all product instances installed. An enumeration of installed product instances. Gets the instance for the current process path. The instance for the current process path. Gets the instance for the given path. Path used to determine instance The instance for the given path. The state of an . The instance state has not been determined. The instance installation path exists. A product is registered to the instance. No reboot is required for the instance. No errors were reported for the instance. The instance represents a complete install. A enumerator of installed objects. Retrieves the next set of product instances in the enumeration sequence. The number of product instances to retrieve. A pointer to an array of . A pointer to the number of product instances retrieved. If celt is 1 this parameter may be NULL. Skips the next set of product instances in the enumeration sequence. The number of product instances to skip. Resets the enumeration sequence to the beginning. Creates a new enumeration object in the same state as the current enumeration object: the new object points to the same place in the enumeration sequence. A pointer to a pointer to a new interface. If the method fails, this parameter is undefined. Provides named properties. You can get this from an , , or derivative. Gets an array of property names in this property store. An array of property names in this property store. Gets the value of a named property in this property store. The name of the property to get. The value of the property. Information about the error state of the instance. Gets an array of failed package references. An array of failed package references. Gets an array of skipped package references. An array of skipped package references. A reference to a failed package. You can enumerate all properties of basic types by casting to an . Gets the general package identifier. The general package identifier. Gets the version of the package. The version of the package. Gets the target process architecture of the package. The target process architecture of the package. Gets the language and optional region identifier. The language and optional region identifier. Gets the build branch of the package. The build branch of the package. Gets the type of the package. The type of the package. Gets the unique identifier consisting of all defined tokens. The unique identifier consisting of all defined tokens. Gets a value indicating whether the package refers to an external extension. A value indicating whether the package refers to an external extension. Information about a catalog used to install an instance. Gets catalog information properties. An containing catalog information properties. The property is not defined or invalid. Gets a value indicating whether the catalog is a prerelease. A value indicating whether the catalog is a prerelease. The property is not defined or invalid. Functions for matching file names with patterns. Cache of the list of invalid path characters, because this method returns a clone (for security reasons) which can cause significant transient allocations The type of entity that GetFileSystemEntries should return. Delegate defines the GetFileSystemEntries signature that GetLongPathName uses to enumerate directories on the file system. Files, Directories, or Files and Directories The path to search. The file pattern. The array of filesystem entries. Determines whether the given path has any wild card characters. Determines whether the given path has any wild card characters. Determines whether the given path has any wild card characters. Determines whether the given path has any wild card characters or any semicolons. Get the files and\or folders specified by the given path and pattern. Whether Files, Directories or both. The path to search. The pattern to search. The directory for the project within which the call is made If true the project directory should be stripped Returns an array of file system entries matching the specified search criteria. Inaccessible or non-existent file system entries are skipped. Array of matching file system entries (can be empty). Same as Directory.GetFiles(...) except that files that aren't accessible are skipped instead of throwing an exception. Other exceptions are passed through. The path. The pattern. The project directory Files that can be accessed. Same as Directory.GetDirectories(...) except that files that aren't accessible are skipped instead of throwing an exception. Other exceptions are passed through. The path. Pattern to match Accessible directories. Given a path name, get its long version. The short path. The long path. Given a path name, get its long version. The short path. Delegate. The long path. Given a filespec, split it into left-most 'fixed' dir part, middle 'wildcard' dir part, and filename part. The filename part may have wildcard characters in it. The filespec to be decomposed. Receives the fixed directory part. The wildcard directory part. The filename part. Delegate. Do most of the grunt work of splitting the filespec into parts. Does not handle post-processing common to the different matching paths. The filespec to be decomposed. Receives the fixed directory part. The wildcard directory part. The filename part. Removes the leading ".\" from all of the paths in the array. Paths to remove .\ from. Checks if the char is a DirectorySeparatorChar or a AltDirectorySeparatorChar Removes the current directory converting the file back to relative path Paths to remove current directory from. Get all files that match either the file-spec or the regular expression. List of files that gets populated. The path to enumerate The remaining, wildcard part of the directory. The filespec. Wild-card matching. If true, then recursion is required. Delegate. Given a file spec, create a regular expression that will match that file spec. PERF WARNING: this method is called in performance-critical scenarios, so keep it fast and cheap The fixed directory part. The wildcard directory part. The filename part. Receives whether this pattern is legal or not. The regular expression string. Given a filespec, get the information needed for file matching. The filespec. Receives the regular expression. Receives the flag that is true if recursion is required. Receives the flag that is true if the filespec is legal. Delegate. Given a filespec, get the information needed for file matching. The filespec. Receives the fixed directory part. Receives the wildcard directory part. Receives the filename part. Receives the regular expression. Receives the flag that is true if recursion is required. Receives the flag that is true if the filespec is legal. Delegate. The results of a match between a filespec and a file name. Default constructor. Given a pattern (filespec) and a candidate filename (fileToMatch) return matching information. The filespec. The candidate to match against. The result class. Given a filespec, find the files that match. Will never throw IO exceptions: if there is no match, returns the input verbatim. The project directory. Get files that match the given file spec. Whether to return folders matching pattern Optional interaction context. If omitted will be used The array of files. Given a filespec, find the files that match. Will never throw IO exceptions: if there is no match, returns the input verbatim. The project directory. Get files that match the given file spec. The array of files. Given a filespec, find the files that match. Will never throw IO exceptions: if there is no match, returns the input verbatim. The project directory. Get files that match the given file spec. Get files that match the given file spec. Determine whether a directory exists. Whether to return folders too The array of files. 's input needs to be normalized according to the file system used Returns original string Original string Normalizes input string according to match files system Optional interaction context. If omitted will be used Normalized string The ASM_NAME enumeration property ID describes the valid names of the name-value pairs in an assembly name. See the .NET Framework SDK for a description of these properties. The CREATE_ASM_NAME_OBJ_FLAGS enumeration contains the following values: CANOF_PARSE_DISPLAY_NAME - If this flag is specified, the szAssemblyName parameter is a full assembly name and is parsed to the individual properties. If the flag is not specified, szAssemblyName is the "Name" portion of the assembly name. CANOF_SET_DEFAULT_VALUES - If this flag is specified, certain properties, such as processor architecture, are set to their default values. The ASM_CACHE_FLAGS enumeration contains the following values: ASM_CACHE_ZAP - Enumerates the cache of precompiled assemblies by using Ngen.exe. ASM_CACHE_GAC - Enumerates the GAC. ASM_CACHE_DOWNLOAD - Enumerates the assemblies that have been downloaded on-demand or that have been shadow-copied. The FUSION_INSTALL_REFERENCE structure represents a reference that is made when an application has installed an assembly in the GAC. The fields of the structure are defined as follows: cbSize - The size of the structure in bytes. dwFlags - Reserved, must be zero. guidScheme - The entity that adds the reference. szIdentifier - A unique string that identifies the application that installed the assembly. szNonCannonicalData - A string that is only understood by the entity that adds the reference. The GAC only stores this string. Possible values for the guidScheme field can be one of the following: FUSION_REFCOUNT_MSI_GUID - The assembly is referenced by an application that has been installed by using Windows Installer. The szIdentifier field is set to MSI, and szNonCannonicalData is set to Windows Installer. This scheme must only be used by Windows Installer itself. FUSION_REFCOUNT_UNINSTALL_SUBKEY_GUID - The assembly is referenced by an application that appears in Add/Remove Programs. The szIdentifier field is the token that is used to register the application with Add/Remove programs. FUSION_REFCOUNT_FILEPATH_GUID - The assembly is referenced by an application that is represented by a file in the file system. The szIdentifier field is the path to this file. FUSION_REFCOUNT_OPAQUE_STRING_GUID - The assembly is referenced by an application that is only represented by an opaque string. The szIdentifier is this opaque string. The GAC does not perform existence checking for opaque references when you remove this. The ASSEMBLY_INFO structure represents information about an assembly in the assembly cache. The fields of the structure are defined as follows: cbAssemblyInfo - Size of the structure in bytes. Permits additions to the structure in future version of the .NET Framework. dwAssemblyFlags - Indicates one or more of the ASSEMBLYINFO_FLAG_* bits. uliAssemblySizeInKB - The size of the files that make up the assembly in kilobytes (KB). pszCurrentAssemblyPathBuf - A pointer to a string buffer that holds the current path of the directory that contains the files that make up the assembly. The path must end with a zero. cchBuf - Size of the buffer that the pszCurrentAssemblyPathBug field points to. dwAssemblyFlags can have one of the following values: ASSEMBLYINFO_FLAG__INSTALLED - Indicates that the assembly is actually installed. Always set in current version of the .NET Framework. ASSEMBLYINFO_FLAG__PAYLOADRESIDENT - Never set in the current version of the .NET Framework. The key entry point for reading the assembly cache. Pointer to return IAssemblyCache must be 0 An instance of IAssemblyName is obtained by calling the CreateAssemblyNameObject API. Pointer to a memory location that receives the IAssemblyName pointer that is created. A string representation of the assembly name or of a full assembly reference that is determined by dwFlags. The string representation can be null. Zero or more of the bits that are defined in the CREATE_ASM_NAME_OBJ_FLAGS enumeration. Must be null. To obtain an instance of the CreateAssemblyEnum API, call the CreateAssemblyNameObject API. Pointer to a memory location that contains the IAssemblyEnum pointer. Must be null. An assembly name that is used to filter the enumeration. Can be null to enumerate all assemblies in the GAC. Exactly one bit from the ASM_CACHE_FLAGS enumeration. Must be NULL. To obtain an instance of the CreateInstallReferenceEnum API, call the CreateInstallReferenceEnum API. A pointer to a memory location that receives the IInstallReferenceEnum pointer. The assembly name for which the references are enumerated. Must be zero. Must be null. The GetCachePath API returns the storage location of the GAC. Exactly one of the bits defined in the ASM_CACHE_FLAGS enumeration. Pointer to a buffer that is to receive the path of the GAC as a Unicode string. Length of the pwszCachePath buffer, in Unicode characters. GUID value for element guidScheme in the struct FUSION_INSTALL_REFERENCE The assembly is referenced by an application that has been installed by using Windows Installer. The szIdentifier field is set to MSI, and szNonCannonicalData is set to Windows Installer. This scheme must only be used by Windows Installer itself. GUID value for element guidScheme in the struct FUSION_INSTALL_REFERENCE GUID value for element guidScheme in the struct FUSION_INSTALL_REFERENCE GUID value for element guidScheme in the struct FUSION_INSTALL_REFERENCE Use this method as a start for the GAC API IAssemblyCache COM interface Get the next assembly name in the current enumerator or fail 0 if the enumeration is not at its end The IAssemblyCache interface is the top-level interface that provides access to the GAC. The IAssemblyCache::UninstallAssembly method removes a reference to an assembly from the GAC. If other applications hold no other references to the assembly, the files that make up the assembly are removed from the GAC. No flags defined. Must be zero. The name of the assembly. A zero-ended Unicode string. A pointer to a FUSION_INSTALL_REFERENCE structure. Although this is not recommended, this parameter can be null. The assembly is installed without an application reference, or all existing application references are gone. Pointer to an integer that indicates the action that is performed by the function. The return values are defined as follows: S_OK - The assembly has been uninstalled. S_FALSE - The operation succeeded, but the assembly was not removed from the GAC. The reason is described in pulDisposition. NOTE: If pulDisposition is not null, pulDisposition contains one of the following values: IASSEMBLYCACHE_UNINSTALL_DISPOSITION_UNINSTALLED - The assembly files have been removed from the GAC. IASSEMBLYCACHE_UNINSTALL_DISPOSITION_STILL_IN_USE - An application is using the assembly. This value is returned on Microsoft Windows 95 and Microsoft Windows 98. IASSEMBLYCACHE_UNINSTALL_DISPOSITION_ALREADY_UNINSTALLED - The assembly does not exist in the GAC. IASSEMBLYCACHE_UNINSTALL_DISPOSITION_DELETE_PENDING - Not used. IASSEMBLYCACHE_UNINSTALL_DISPOSITION_HAS_INSTALL_REFERENCES - The assembly has not been removed from the GAC because another application reference exists. IASSEMBLYCACHE_UNINSTALL_DISPOSITION_REFERENCE_NOT_FOUND - The reference that is specified in pRefData is not found in the GAC. The IAssemblyCache::QueryAssemblyInfo method retrieves information about an assembly from the GAC. One of QUERYASMINFO_FLAG_VALIDATE or QUERYASMINFO_FLAG_GETSIZE: *_VALIDATE - Performs validation of the files in the GAC against the assembly manifest, including hash verification and strong name signature verification. *_GETSIZE - Returns the size of all files in the assembly (disk footprint). If this is not specified, the ASSEMBLY_INFO::uliAssemblySizeInKB field is not modified. Undocumented Undocumented The IAssemblyCache::InstallAssembly method adds a new assembly to the GAC. The assembly must be persisted in the file system and is copied to the GAC. At most, one of the bits of the IASSEMBLYCACHE_INSTALL_FLAG_* values can be specified: *_REFRESH - If the assembly is already installed in the GAC and the file version numbers of the assembly being installed are the same or later, the files are replaced. *_FORCE_REFRESH - The files of an existing assembly are overwritten regardless of their version number. A string pointing to the dynamic-linked library (DLL) that contains the assembly manifest. Other assembly files must reside in the same directory as the DLL that contains the assembly manifest. A pointer to a FUSION_INSTALL_REFERENCE that indicates the application on whose behalf the assembly is being installed. Although this is not recommended, this parameter can be null, but this leaves the assembly without any application reference. The IAssemblyName interface represents an assembly name. An assembly name includes a predetermined set of name-value pairs. The assembly name is described in detail in the .NET Framework SDK. The IAssemblyName::SetProperty method adds a name-value pair to the assembly name, or, if a name-value pair with the same name already exists, modifies or deletes the value of a name-value pair. The ID that represents the name part of the name-value pair that is to be added or to be modified. Valid property IDs are defined in the ASM_NAME enumeration. A pointer to a buffer that contains the value of the property. The length of the pvProperty buffer in bytes. If cbProperty is zero, the name-value pair is removed from the assembly name. The IAssemblyName::GetProperty method retrieves the value of a name-value pair in the assembly name that specifies the name. The ID that represents the name of the name-value pair whose value is to be retrieved. Specified property IDs are defined in the ASM_NAME enumeration. A pointer to a buffer that is to contain the value of the property. The length of the pvProperty buffer, in bytes. The IAssemblyName::Finalize method freezes an assembly name. Additional calls to IAssemblyName::SetProperty are unsuccessful after this method has been called. The IAssemblyName::GetDisplayName method returns a string representation of the assembly name. A pointer to a buffer that is to contain the display name. The display name is returned in Unicode. The size of the buffer in characters (on input). The length of the returned display name (on return). One or more of the bits defined in the ASM_DISPLAY_FLAGS enumeration: *_VERSION - Includes the version number as part of the display name. *_CULTURE - Includes the culture. *_PUBLIC_KEY_TOKEN - Includes the public key token. *_PUBLIC_KEY - Includes the public key. *_CUSTOM - Includes the custom part of the assembly name. *_PROCESSORARCHITECTURE - Includes the processor architecture. *_LANGUAGEID - Includes the language ID. http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpguide/html/cpcondefaultmarshalingforstrings.asp Undocumented The IAssemblyName::GetName method returns the name part of the assembly name. Size of the pwszName buffer (on input). Length of the name (on return). Pointer to the buffer that is to contain the name part of the assembly name. http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpguide/html/cpcondefaultmarshalingforstrings.asp The IAssemblyName::GetVersion method returns the version part of the assembly name. Pointer to a DWORD that contains the upper 32 bits of the version number. Pointer to a DWORD that contain the lower 32 bits of the version number. The IAssemblyName::IsEqual method compares the assembly name to another assembly names. The assembly name to compare to. Indicates which part of the assembly name to use in the comparison. Values are one or more of the bits defined in the ASM_CMP_FLAGS enumeration. The IAssemblyName::Clone method creates a copy of an assembly name. The IAssemblyEnum interface enumerates the assemblies in the GAC. The IAssemblyEnum::GetNextAssembly method enumerates the assemblies in the GAC. Must be null. Pointer to a memory location that is to receive the interface pointer to the assembly name of the next assembly that is enumerated. Must be zero. Undocumented. Best guess: reset the enumeration to the first assembly. Undocumented. Create a copy of the assembly enum that is independently enumerable. The IInstallReferenceItem interface represents a reference that has been set on an assembly in the GAC. Instances of IInstallReferenceIteam are returned by the IInstallReferenceEnum interface. The IInstallReferenceItem::GetReference method returns a FUSION_INSTALL_REFERENCE structure. A pointer to a FUSION_INSTALL_REFERENCE structure. The memory is allocated by the GetReference method and is freed when IInstallReferenceItem is released. Callers must not hold a reference to this buffer after the IInstallReferenceItem object is released. Must be zero. Must be null. The IInstallReferenceEnum interface enumerates all references that are set on an assembly in the GAC. NOTE: References that belong to the assembly are locked for changes while those references are being enumerated. IInstallReferenceEnum::GetNextInstallReferenceItem returns the next reference information for an assembly. Pointer to a memory location that receives the IInstallReferenceItem pointer. Must be zero. Must be null. Undocumented. Probably only for internal use. Undocumented. Undocumented. Undocumented. https://github.com/samuelneff/MimeTypeMap>