Files
git.stella-ops.org/local-nugets/microsoft.extensions.configuration.binder/8.0.0/lib/net6.0/Microsoft.Extensions.Configuration.Binder.xml
StellaOps Bot 967ae0ab16 nugets update
2025-11-22 16:41:08 +02:00

286 lines
18 KiB
XML

<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.Extensions.Configuration.Binder</name>
</assembly>
<members>
<member name="T:Microsoft.Extensions.Configuration.BinderOptions">
<summary>
Options class used by the <see cref="T:Microsoft.Extensions.Configuration.ConfigurationBinder"/>.
</summary>
</member>
<member name="P:Microsoft.Extensions.Configuration.BinderOptions.BindNonPublicProperties">
<summary>
When false (the default), the binder will only attempt to set public properties.
If true, the binder will attempt to set all non read-only properties.
</summary>
</member>
<member name="P:Microsoft.Extensions.Configuration.BinderOptions.ErrorOnUnknownConfiguration">
<summary>
When false (the default), no exceptions are thrown when trying to convert a value or when a configuration
key is found for which the provided model object does not have an appropriate property which matches the key's name.
When true, an <see cref="T:System.InvalidOperationException"/> is thrown with a description
of the error.
</summary>
</member>
<member name="T:Microsoft.Extensions.Configuration.ConfigurationBinder">
<summary>
Static helper class that allows binding strongly typed objects to configuration values.
</summary>
</member>
<member name="M:Microsoft.Extensions.Configuration.ConfigurationBinder.Get``1(Microsoft.Extensions.Configuration.IConfiguration)">
<summary>
Attempts to bind the configuration instance to a new instance of type T.
If this configuration section has a value, that will be used.
Otherwise binding by matching property names against configuration keys recursively.
</summary>
<typeparam name="T">The type of the new instance to bind.</typeparam>
<param name="configuration">The configuration instance to bind.</param>
<returns>The new instance of T if successful, default(T) otherwise.</returns>
</member>
<member name="M:Microsoft.Extensions.Configuration.ConfigurationBinder.Get``1(Microsoft.Extensions.Configuration.IConfiguration,System.Action{Microsoft.Extensions.Configuration.BinderOptions})">
<summary>
Attempts to bind the configuration instance to a new instance of type T.
If this configuration section has a value, that will be used.
Otherwise binding by matching property names against configuration keys recursively.
</summary>
<typeparam name="T">The type of the new instance to bind.</typeparam>
<param name="configuration">The configuration instance to bind.</param>
<param name="configureOptions">Configures the binder options.</param>
<returns>The new instance of T if successful, default(T) otherwise.</returns>
</member>
<member name="M:Microsoft.Extensions.Configuration.ConfigurationBinder.Get(Microsoft.Extensions.Configuration.IConfiguration,System.Type)">
<summary>
Attempts to bind the configuration instance to a new instance of type T.
If this configuration section has a value, that will be used.
Otherwise binding by matching property names against configuration keys recursively.
</summary>
<param name="configuration">The configuration instance to bind.</param>
<param name="type">The type of the new instance to bind.</param>
<returns>The new instance if successful, null otherwise.</returns>
</member>
<member name="M:Microsoft.Extensions.Configuration.ConfigurationBinder.Get(Microsoft.Extensions.Configuration.IConfiguration,System.Type,System.Action{Microsoft.Extensions.Configuration.BinderOptions})">
<summary>
Attempts to bind the configuration instance to a new instance of type T.
If this configuration section has a value, that will be used.
Otherwise binding by matching property names against configuration keys recursively.
</summary>
<param name="configuration">The configuration instance to bind.</param>
<param name="type">The type of the new instance to bind.</param>
<param name="configureOptions">Configures the binder options.</param>
<returns>The new instance if successful, null otherwise.</returns>
</member>
<member name="M:Microsoft.Extensions.Configuration.ConfigurationBinder.Bind(Microsoft.Extensions.Configuration.IConfiguration,System.String,System.Object)">
<summary>
Attempts to bind the given object instance to the configuration section specified by the key by matching property names against configuration keys recursively.
</summary>
<param name="configuration">The configuration instance to bind.</param>
<param name="key">The key of the configuration section to bind.</param>
<param name="instance">The object to bind.</param>
</member>
<member name="M:Microsoft.Extensions.Configuration.ConfigurationBinder.Bind(Microsoft.Extensions.Configuration.IConfiguration,System.Object)">
<summary>
Attempts to bind the given object instance to configuration values by matching property names against configuration keys recursively.
</summary>
<param name="configuration">The configuration instance to bind.</param>
<param name="instance">The object to bind.</param>
</member>
<member name="M:Microsoft.Extensions.Configuration.ConfigurationBinder.Bind(Microsoft.Extensions.Configuration.IConfiguration,System.Object,System.Action{Microsoft.Extensions.Configuration.BinderOptions})">
<summary>
Attempts to bind the given object instance to configuration values by matching property names against configuration keys recursively.
</summary>
<param name="configuration">The configuration instance to bind.</param>
<param name="instance">The object to bind.</param>
<param name="configureOptions">Configures the binder options.</param>
</member>
<member name="M:Microsoft.Extensions.Configuration.ConfigurationBinder.GetValue``1(Microsoft.Extensions.Configuration.IConfiguration,System.String)">
<summary>
Extracts the value with the specified key and converts it to type T.
</summary>
<typeparam name="T">The type to convert the value to.</typeparam>
<param name="configuration">The configuration.</param>
<param name="key">The key of the configuration section's value to convert.</param>
<returns>The converted value.</returns>
</member>
<member name="M:Microsoft.Extensions.Configuration.ConfigurationBinder.GetValue``1(Microsoft.Extensions.Configuration.IConfiguration,System.String,``0)">
<summary>
Extracts the value with the specified key and converts it to type T.
</summary>
<typeparam name="T">The type to convert the value to.</typeparam>
<param name="configuration">The configuration.</param>
<param name="key">The key of the configuration section's value to convert.</param>
<param name="defaultValue">The default value to use if no value is found.</param>
<returns>The converted value.</returns>
</member>
<member name="M:Microsoft.Extensions.Configuration.ConfigurationBinder.GetValue(Microsoft.Extensions.Configuration.IConfiguration,System.Type,System.String)">
<summary>
Extracts the value with the specified key and converts it to the specified type.
</summary>
<param name="configuration">The configuration.</param>
<param name="type">The type to convert the value to.</param>
<param name="key">The key of the configuration section's value to convert.</param>
<returns>The converted value.</returns>
</member>
<member name="M:Microsoft.Extensions.Configuration.ConfigurationBinder.GetValue(Microsoft.Extensions.Configuration.IConfiguration,System.Type,System.String,System.Object)">
<summary>
Extracts the value with the specified key and converts it to the specified type.
</summary>
<param name="configuration">The configuration.</param>
<param name="type">The type to convert the value to.</param>
<param name="key">The key of the configuration section's value to convert.</param>
<param name="defaultValue">The default value to use if no value is found.</param>
<returns>The converted value.</returns>
</member>
<member name="M:System.ThrowHelper.ThrowIfNull(System.Object,System.String)">
<summary>Throws an <see cref="T:System.ArgumentNullException"/> if <paramref name="argument"/> is null.</summary>
<param name="argument">The reference type argument to validate as non-null.</param>
<param name="paramName">The name of the parameter with which <paramref name="argument"/> corresponds.</param>
</member>
<member name="M:System.ThrowHelper.IfNullOrWhitespace(System.String,System.String)">
<summary>
Throws either an <see cref="T:System.ArgumentNullException"/> or an <see cref="T:System.ArgumentException"/>
if the specified string is <see langword="null"/> or whitespace respectively.
</summary>
<param name="argument">String to be checked for <see langword="null"/> or whitespace.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="T:System.Diagnostics.CodeAnalysis.RequiresDynamicCodeAttribute">
<summary>
Indicates that the specified method requires the ability to generate new code at runtime,
for example through <see cref="N:System.Reflection"/>.
</summary>
<remarks>
This allows tools to understand which methods are unsafe to call when compiling ahead of time.
</remarks>
</member>
<member name="M:System.Diagnostics.CodeAnalysis.RequiresDynamicCodeAttribute.#ctor(System.String)">
<summary>
Initializes a new instance of the <see cref="T:System.Diagnostics.CodeAnalysis.RequiresDynamicCodeAttribute"/> class
with the specified message.
</summary>
<param name="message">
A message that contains information about the usage of dynamic code.
</param>
</member>
<member name="P:System.Diagnostics.CodeAnalysis.RequiresDynamicCodeAttribute.Message">
<summary>
Gets a message that contains information about the usage of dynamic code.
</summary>
</member>
<member name="P:System.Diagnostics.CodeAnalysis.RequiresDynamicCodeAttribute.Url">
<summary>
Gets or sets an optional URL that contains more information about the method,
why it requires dynamic code, and what options a consumer has to deal with it.
</summary>
</member>
<member name="P:System.SR.Error_CannotActivateAbstractOrInterface">
<summary>Cannot create instance of type '{0}' because it is either abstract or an interface.</summary>
</member>
<member name="P:System.SR.Error_CannotBindToConstructorParameter">
<summary>Cannot create instance of type '{0}' because one or more parameters cannot be bound to. Constructor parameters cannot be declared as in, out, or ref. Invalid parameters are: '{1}'</summary>
</member>
<member name="P:System.SR.Error_ConstructorParametersDoNotMatchProperties">
<summary>Cannot create instance of type '{0}' because one or more parameters cannot be bound to. Constructor parameters must have corresponding properties. Fields are not supported. Missing properties are: '{1}'</summary>
</member>
<member name="P:System.SR.Error_FailedBinding">
<summary>Failed to convert configuration value at '{0}' to type '{1}'.</summary>
</member>
<member name="P:System.SR.Error_FailedToActivate">
<summary>Failed to create instance of type '{0}'.</summary>
</member>
<member name="P:System.SR.Error_GeneralErrorWhenBinding">
<summary>'{0}' was set and binding has failed. The likely cause is an invalid configuration value.</summary>
</member>
<member name="P:System.SR.Error_MissingConfig">
<summary>'{0}' was set on the provided {1}, but the following properties were not found on the instance of {2}: {3}</summary>
</member>
<member name="P:System.SR.Error_MissingPublicInstanceConstructor">
<summary>Cannot create instance of type '{0}' because it is missing a public instance constructor.</summary>
</member>
<member name="P:System.SR.Error_MultipleParameterizedConstructors">
<summary>Cannot create instance of type '{0}' because it has multiple public parameterized constructors.</summary>
</member>
<member name="P:System.SR.Error_ParameterBeingBoundToIsUnnamed">
<summary>Cannot create instance of type '{0}' because one or more parameters are unnamed.</summary>
</member>
<member name="P:System.SR.Error_ParameterHasNoMatchingConfig">
<summary>Cannot create instance of type '{0}' because parameter '{1}' has no matching config. Each parameter in the constructor that does not have a default value must have a corresponding config entry.</summary>
</member>
<member name="P:System.SR.Error_UnsupportedMultidimensionalArray">
<summary>Cannot create instance of type '{0}' because multidimensional arrays are not supported.</summary>
</member>
<member name="T:System.Runtime.InteropServices.LibraryImportAttribute">
<summary>
Attribute used to indicate a source generator should create a function for marshalling
arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time.
</summary>
<remarks>
This attribute is meaningless if the source generator associated with it is not enabled.
The current built-in source generator only supports C# and only supplies an implementation when
applied to static, partial, non-generic methods.
</remarks>
</member>
<member name="M:System.Runtime.InteropServices.LibraryImportAttribute.#ctor(System.String)">
<summary>
Initializes a new instance of the <see cref="T:System.Runtime.InteropServices.LibraryImportAttribute"/>.
</summary>
<param name="libraryName">Name of the library containing the import.</param>
</member>
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.LibraryName">
<summary>
Gets the name of the library containing the import.
</summary>
</member>
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.EntryPoint">
<summary>
Gets or sets the name of the entry point to be called.
</summary>
</member>
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshalling">
<summary>
Gets or sets how to marshal string arguments to the method.
</summary>
<remarks>
If this field is set to a value other than <see cref="F:System.Runtime.InteropServices.StringMarshalling.Custom" />,
<see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType" /> must not be specified.
</remarks>
</member>
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType">
<summary>
Gets or sets the <see cref="T:System.Type"/> used to control how string arguments to the method are marshalled.
</summary>
<remarks>
If this field is specified, <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshalling" /> must not be specified
or must be set to <see cref="F:System.Runtime.InteropServices.StringMarshalling.Custom" />.
</remarks>
</member>
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.SetLastError">
<summary>
Gets or sets whether the callee sets an error (SetLastError on Windows or errno
on other platforms) before returning from the attributed method.
</summary>
</member>
<member name="T:System.Runtime.InteropServices.StringMarshalling">
<summary>
Specifies how strings should be marshalled for generated p/invokes
</summary>
</member>
<member name="F:System.Runtime.InteropServices.StringMarshalling.Custom">
<summary>
Indicates the user is suppling a specific marshaller in <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType"/>.
</summary>
</member>
<member name="F:System.Runtime.InteropServices.StringMarshalling.Utf8">
<summary>
Use the platform-provided UTF-8 marshaller.
</summary>
</member>
<member name="F:System.Runtime.InteropServices.StringMarshalling.Utf16">
<summary>
Use the platform-provided UTF-16 marshaller.
</summary>
</member>
</members>
</doc>