ConfigurationBuilder Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Uygulamada kullanmak üzere anahtar/değer tabanlı yapılandırma ayarları oluşturmak için kullanılır.
public ref class ConfigurationBuilder : Microsoft::Extensions::Configuration::IConfigurationBuilder
public class ConfigurationBuilder : Microsoft.Extensions.Configuration.IConfigurationBuilder
type ConfigurationBuilder = class
interface IConfigurationBuilder
Public Class ConfigurationBuilder
Implements IConfigurationBuilder
- Devralma
-
ConfigurationBuilder
- Uygulamalar
Açıklamalar
Bu sınıfı kullanarak yapılandırma değerlerini örneğin bir JSON dosyasında depolayabilir ve çalışma zamanında alabilirsiniz. Daha fazla bilgi için bkz . Yapılandırma - temel örnek.
Bir uygulamayı .NET Core 3.1 veya sonraki bir sürüme geçiriyorsanız, uygulamanızı yapılandırmak için daha önce kullanmış olabileceğiniz app.config dosya işlevselliğini değiştirmek için bu sınıfı kullanabilirsiniz.
Örnek
Aşağıdaki kod parçacığı, çalışma zamanında bir ConfigurationBuilder
JSON dosyasından dize değeri almak için bir nesne oluşturan basitleştirilmiş bir uygulamayı gösterir.
using Microsoft.Extensions.Configuration;
IConfigurationBuilder builder = new ConfigurationBuilder().AddJsonFile("appsettings.json", false, true);
IConfigurationRoot root = builder.Build();
Console.WriteLine($"Hello, { root["weather"] } world!");
/* This program outputs the following text:
*
* Hello, stormy world!
*/
JSON dosyasının içeriği burada gösterilir.
{
"weather": "stormy"
}
Oluşturucular
ConfigurationBuilder() |
ConfigurationBuilder sınıfının yeni bir örneğini başlatır. |
Özellikler
Properties |
ve kayıtlı yapılandırma sağlayıcıları arasında IConfigurationBuilder veri paylaşmak için kullanılabilecek bir anahtar/değer koleksiyonu alır. |
Sources |
Yapılandırma değerlerini almak için kullanılan kaynakları alır. |
Yöntemler
Add(IConfigurationSource) |
Yeni bir yapılandırma kaynağı ekler. |
Build() |
içinde kayıtlı Sourcessağlayıcı kümesinden anahtarlar ve değerlerle bir IConfiguration oluşturur. |
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
Uzantı Metotları
AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String) |
Uygulama meta verileri için bir yapılandırma sağlayıcısı kaydeder. |
AddAzureKeyVault(IConfigurationBuilder, AzureKeyVaultConfigurationOptions) |
Azure KeyVault'tan yapılandırma değerlerini okuyan bir IConfigurationProvider ekler. |
AddAzureKeyVault(IConfigurationBuilder, String) |
Azure KeyVault'tan yapılandırma değerlerini okuyan bir IConfigurationProvider ekler. |
AddAzureKeyVault(IConfigurationBuilder, String, KeyVaultClient, IKeyVaultSecretManager) |
Azure KeyVault'tan yapılandırma değerlerini okuyan bir IConfigurationProvider ekler. |
AddAzureKeyVault(IConfigurationBuilder, String, IKeyVaultSecretManager) |
Azure KeyVault'tan yapılandırma değerlerini okuyan bir IConfigurationProvider ekler. |
AddAzureKeyVault(IConfigurationBuilder, String, String, X509Certificate2) |
Azure KeyVault'tan yapılandırma değerlerini okuyan bir IConfigurationProvider ekler. |
AddAzureKeyVault(IConfigurationBuilder, String, String, X509Certificate2, IKeyVaultSecretManager) |
Azure KeyVault'tan yapılandırma değerlerini okuyan bir IConfigurationProvider ekler. |
AddAzureKeyVault(IConfigurationBuilder, String, String, String) |
Azure KeyVault'tan yapılandırma değerlerini okuyan bir IConfigurationProvider ekler. |
AddAzureKeyVault(IConfigurationBuilder, String, String, String, IKeyVaultSecretManager) |
Azure KeyVault'tan yapılandırma değerlerini okuyan bir IConfigurationProvider ekler. |
AddConfiguration(IConfigurationBuilder, IConfiguration) |
öğesine |
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean) |
öğesine |
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>) |
Komut satırından yapılandırma değerlerini okuyan bir IConfigurationProvider ekler. |
AddCommandLine(IConfigurationBuilder, String[]) |
Komut satırından yapılandırma değerlerini okuyan bir CommandLineConfigurationProvider ekler. |
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>) |
Belirtilen anahtar eşlemelerini kullanarak komut satırından yapılandırma değerlerini okuyan bir CommandLineConfigurationProvider ekler. |
Add<TSource>(IConfigurationBuilder, Action<TSource>) |
Yeni bir yapılandırma kaynağı ekler. |
AddUserSecrets(IConfigurationBuilder) |
Kullanıcı gizli dizileri yapılandırma kaynağını ekler. derlemesinde GetEntryAssembly() öğesinin bir örneğini UserSecretsIdAttributearar. |
AddUserSecrets(IConfigurationBuilder, Assembly) |
Kullanıcı gizli dizileri yapılandırma kaynağını ekler. |
AddUserSecrets(IConfigurationBuilder, String) |
Belirtilen gizli dizi kimliğine sahip kullanıcı gizli dizileri yapılandırma kaynağını ekler. |
AddUserSecrets<T>(IConfigurationBuilder) |
Kullanıcı gizli dizileri yapılandırma kaynağını ekler. türünü içeren |
AddEnvironmentVariables(IConfigurationBuilder) |
Ortam değişkenlerinden yapılandırma değerlerini okuyan bir IConfigurationProvider ekler. |
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>) |
Ortam değişkenlerinden yapılandırma değerlerini okuyan bir IConfigurationProvider ekler. |
AddEnvironmentVariables(IConfigurationBuilder, String) |
IConfigurationProvider Belirtilen ön eke sahip ortam değişkenlerinden yapılandırma değerlerini okuyan bir ekler. |
GetFileLoadExceptionHandler(IConfigurationBuilder) |
Dosya tabanlı sağlayıcılar için kullanılacak varsayılan IFileProvider değeri alır. |
GetFileProvider(IConfigurationBuilder) |
Dosya tabanlı sağlayıcılar için kullanılacak varsayılan IFileProvider değeri alır. |
SetBasePath(IConfigurationBuilder, String) |
Dosya tabanlı sağlayıcılar için FileProvider'ı temel yolu olan bir PhysicalFileProvider olarak ayarlar. |
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>) |
Hata oluştuğunda dosya tabanlı sağlayıcılar için çağrılacak varsayılan eylemi ayarlar. |
SetFileProvider(IConfigurationBuilder, IFileProvider) |
Dosya tabanlı sağlayıcılar için kullanılacak varsayılan IFileProvider değeri ayarlar. |
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
öğesine |
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>) |
öğesine |
AddIniFile(IConfigurationBuilder, String) |
konumundaki INI yapılandırma sağlayıcısını |
AddIniFile(IConfigurationBuilder, String, Boolean) |
konumundaki INI yapılandırma sağlayıcısını |
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean) |
konumundaki INI yapılandırma sağlayıcısını |
AddIniStream(IConfigurationBuilder, Stream) |
öğesine |
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
öğesine |
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>) |
öğesine |
AddJsonFile(IConfigurationBuilder, String) |
konumundaki JSON yapılandırma sağlayıcısını |
AddJsonFile(IConfigurationBuilder, String, Boolean) |
konumundaki JSON yapılandırma sağlayıcısını |
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean) |
konumundaki JSON yapılandırma sağlayıcısını |
AddJsonStream(IConfigurationBuilder, Stream) |
öğesine |
AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>) |
Dizinden dosyaları kullanarak yapılandırma ekler. Anahtar olarak dosya adları, değer olarak dosya içeriği kullanılır. |
AddKeyPerFile(IConfigurationBuilder, String) |
Dizinden dosyaları kullanarak yapılandırma ekler. Anahtar olarak dosya adları, değer olarak dosya içeriği kullanılır. |
AddKeyPerFile(IConfigurationBuilder, String, Boolean) |
Dizinden dosyaları kullanarak yapılandırma ekler. Anahtar olarak dosya adları, değer olarak dosya içeriği kullanılır. |
AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean) |
Dizinden dosyaları kullanarak yapılandırma ekler. Anahtar olarak dosya adları, değer olarak dosya içeriği kullanılır. |
AddInMemoryCollection(IConfigurationBuilder) |
bellek yapılandırma sağlayıcısını öğesine |
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>) |
bellek yapılandırma sağlayıcısını öğesine |
AddNewtonsoftJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
öğesine |
AddNewtonsoftJsonFile(IConfigurationBuilder, Action<NewtonsoftJsonConfigurationSource>) |
öğesine |
AddNewtonsoftJsonFile(IConfigurationBuilder, String) |
konumundaki JSON yapılandırma sağlayıcısını |
AddNewtonsoftJsonFile(IConfigurationBuilder, String, Boolean) |
konumundaki JSON yapılandırma sağlayıcısını |
AddNewtonsoftJsonFile(IConfigurationBuilder, String, Boolean, Boolean) |
konumundaki JSON yapılandırma sağlayıcısını |
AddNewtonsoftJsonStream(IConfigurationBuilder, Stream) |
öğesine bir Newtonsoft JSON yapılandırma kaynağı |
AddUserSecrets(IConfigurationBuilder, Assembly) |
Kullanıcı gizli dizileri yapılandırma kaynağını ekler. Bu, kullanıcı gizli dizileri UserSecretsIdAttributekimliğini belirten bir örneğini arar Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerleri koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir. |
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean) |
Kullanıcı gizli dizileri yapılandırma kaynağını ekler. Bu, kullanıcı gizli dizileri UserSecretsIdAttributekimliğini belirten bir örneğini arar Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerleri koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir. |
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean) |
Kullanıcı gizli dizileri yapılandırma kaynağını ekler. Bu, kullanıcı gizli dizileri UserSecretsIdAttributekimliğini belirten bir örneğini arar Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerleri koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir. |
AddUserSecrets(IConfigurationBuilder, String) |
Belirtilen kullanıcı gizli dizileri kimliğine sahip kullanıcı gizli dizileri yapılandırma kaynağını ekler. Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerleri koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir. |
AddUserSecrets(IConfigurationBuilder, String, Boolean) |
Belirtilen kullanıcı gizli dizileri kimliğine sahip kullanıcı gizli dizileri yapılandırma kaynağını ekler. Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerleri koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir. |
AddUserSecrets<T>(IConfigurationBuilder) |
Kullanıcı gizli dizileri yapılandırma kaynağını ekler. kullanıcı gizli dizileri kimliğini belirten bir örneğini UserSecretsIdAttributeiçeren derlemede Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerleri koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir. |
AddUserSecrets<T>(IConfigurationBuilder, Boolean) |
Kullanıcı gizli dizileri yapılandırma kaynağını ekler. kullanıcı gizli dizileri kimliğini belirten bir örneğini UserSecretsIdAttributeiçeren derlemede Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerleri koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir. |
AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean) |
Kullanıcı gizli dizileri yapılandırma kaynağını ekler. kullanıcı gizli dizileri kimliğini belirten bir örneğini UserSecretsIdAttributeiçeren derlemede Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerleri koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir. |
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
öğesine |
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>) |
öğesine |
AddXmlFile(IConfigurationBuilder, String) |
konumundaki |
AddXmlFile(IConfigurationBuilder, String, Boolean) |
konumundaki |
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean) |
konumundaki |
AddXmlStream(IConfigurationBuilder, Stream) |
öğesine |
Şunlara uygulanır
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin