MemoryCache Konstruktoren

Definition

Überlädt

MemoryCache(String, NameValueCollection)

Initialisiert eine neue Instanz der MemoryCache-Klasse.Initializes a new instance of the MemoryCache class.

MemoryCache(String, NameValueCollection, Boolean)

Initialisiert eine neue Instanz der MemoryCache-Klasse.Initializes a new instance of the MemoryCache class.

MemoryCache(String, NameValueCollection)

Initialisiert eine neue Instanz der MemoryCache-Klasse.Initializes a new instance of the MemoryCache class.

public MemoryCache (string name, System.Collections.Specialized.NameValueCollection config = default);
new System.Runtime.Caching.MemoryCache : string * System.Collections.Specialized.NameValueCollection -> System.Runtime.Caching.MemoryCache
Public Sub New (name As String, Optional config As NameValueCollection = null)

Parameter

name
String

Der Name, der beim Nachschlagen von Konfigurationsinformationen verwendet werden soll.The name to use to look up configuration information.

Hinweis Es ist nicht erforderlich, dass für jeden Namen Konfigurationsinformationen vorhanden sind.Note It is not required for configuration information to exist for every name.

Wenn ein passender Konfigurationseintrag vorhanden ist, werden die Konfigurationsinformationen verwendet, um die MemoryCache-Instanz zu konfigurieren.If a matching configuration entry exists, the configuration information is used to configure the MemoryCache instance. Wenn kein entsprechender Konfigurationseintrag vorhanden ist, kann auf den Namen über die Name-Eigenschaft zugegriffen werden, da der angegebene Name der MemoryCache-Instanz zugeordnet ist.If a matching configuration entry does not exist, the name can be accessed through the Name property, because the specified name is associated with the MemoryCache instance. Weitere Informationen über die Speichercachekonfiguration finden Sie unter MemoryCacheElement.For information about memory cache configuration, see MemoryCacheElement.

config
NameValueCollection

Eine Auflistung von Name-Wert-Paaren mit Konfigurationsinformationen zum Konfigurieren des Caches.A collection of name/value pairs of configuration information to use for configuring the cache.

Ausnahmen

name ist null.name is null.

Ein Name bzw. Wert im config-Parameter konnte nicht analysiert werden.A name or value in the config parameter could not be parsed.

Ein Wert in der config-Auflistung ist ungültig.A value in the config collection is invalid.

Hinweise

Wenn die MemoryCache Klasse initialisiert wird, überprüft Sie, ob Konfigurationseinträge vorhanden sind, die möglicherweise überschrieben wurden, indem der optionale config-Parameter im Konstruktor verwendet wurde.When the MemoryCache class is initialized, it checks for configuration entries that might have been overridden by using the optional config parameter in the constructor. Sie können die folgenden Parameter im config-Parameter übergeben.You can pass the following parameters in the config parameter. Alle Werte können als ganze Zahlen übermittelt werden.All values can be passed as integers.

Wenn dieser Konstruktor aufgerufen wird, werden die Konfigurationseinstellungen zuerst aus den Anwendungs Konfigurationsdateien abgerufen.When this constructor is invoked, configuration settings are first retrieved from application configuration files. Wenn in der Anwendungs Konfigurationsdatei keine Konfigurationseinträge vorhanden sind, werden nur die in config bereitgestellten Einstellungen angewendet.If no configuration entries exist in the application configuration file, only the settings provided in config are applied. Wenn die Konfigurationseinträge in der Anwendungskonfiguration vorhanden sind und Informationen auch in configweitergegeben werden, überschreiben die Informationen in der config die Informationen, die aus der Konfigurationsdatei gelesen werden.If the configuration entries in the application configuration exist, and if information is also passed in config, the information in the config overrides the information that is read from the configuration file.

Der Name, der einer Cache Instanz zugewiesen ist, wird auf zweierlei Weise verwendet:The name value that is assigned to a cache instance is used in two ways:

  • , Um die Nachverfolgung mehrerer Cache Instanzen zu unterstützen, wenn mehr als eine Instanz vorhanden ist.To help you keep track of multiple cache instances when more than one instance exists.

  • , Um auf Einstellungen in der Konfigurationsdatei zu verweisen, wenn die MemoryCache Instanz initialisiert wird.To reference settings in the configuration file when the MemoryCache instance is initialized.

    Hinweis

    Es gibt keinen Mechanismus zum Erzwingen eindeutiger Namen für Cache Instanzen.There is no mechanism to enforce unique names for cache instances. Daher ist es möglich, mehrere Cache Instanzen mit demselben Namen zu haben.Therefore, it is possible to have multiple cache instances with the same name.

    Achtung

    Erstellen Sie keine MemoryCache Instanzen, es sei denn, dies ist erforderlich.Do not create MemoryCache instances unless it is required. Wenn Sie Cache Instanzen in Client-und Webanwendungen erstellen, sollten die MemoryCache Instanzen früh im Lebenszyklus der Anwendung erstellt werden.If you create cache instances in client and Web applications, the MemoryCache instances should be created early in the application life cycle. Sie müssen nur die Anzahl der Cache Instanzen erstellen, die in der Anwendung verwendet werden, und Verweise auf die Cache Instanzen in Variablen speichern, auf die Global zugegriffen werden kann.You must create only the number of cache instances that will be used in your application, and store references to the cache instances in variables that can be accessed globally. In ASP.NET-Anwendungen können Sie z. b. die Verweise im Anwendungs Zustand speichern.For example, in ASP.NET applications, you can store the references in application state. Wenn Sie nur eine einzelne Cache Instanz in Ihrer Anwendung erstellen, verwenden Sie den Standard Cache, und rufen Sie aus der Default-Eigenschaft einen Verweis darauf ab, wenn Sie auf den Cache zugreifen müssen.If you create only a single cache instance in your application, use the default cache and get a reference to it from the Default property when you need to access the cache.

MemoryCache(String, NameValueCollection, Boolean)

Initialisiert eine neue Instanz der MemoryCache-Klasse.Initializes a new instance of the MemoryCache class.

public:
 MemoryCache(System::String ^ name, System::Collections::Specialized::NameValueCollection ^ config, bool ignoreConfigSection);
public MemoryCache (string name, System.Collections.Specialized.NameValueCollection config, bool ignoreConfigSection);
new System.Runtime.Caching.MemoryCache : string * System.Collections.Specialized.NameValueCollection * bool -> System.Runtime.Caching.MemoryCache
Public Sub New (name As String, config As NameValueCollection, ignoreConfigSection As Boolean)

Parameter

name
String

Der Name, der beim Nachschlagen von Konfigurationsinformationen verwendet werden soll.The name to use to look up configuration information.

config
NameValueCollection

Eine Auflistung von Name-Wert-Paaren mit Konfigurationsinformationen zum Konfigurieren des Caches.A collection of name/value pairs of configuration information to use for configuring the cache.

ignoreConfigSection
Boolean

Gibt an, ob der Konfigurationsabschnitt ignoriert werden soll.Indicates whether the configuration section should be ignored.

Gilt für: