ConfigurationElement.LockAllElementsExcept Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Auflistung gesperrter Elemente ab.
public:
property System::Configuration::ConfigurationLockCollection ^ LockAllElementsExcept { System::Configuration::ConfigurationLockCollection ^ get(); };
public System.Configuration.ConfigurationLockCollection LockAllElementsExcept { get; }
member this.LockAllElementsExcept : System.Configuration.ConfigurationLockCollection
Public ReadOnly Property LockAllElementsExcept As ConfigurationLockCollection
Eigenschaftswert
Die ConfigurationLockCollection gesperrter Elemente.
Beispiele
Im folgenden Beispiel wird die Verwendung der LockAllElementsExcept-Eigenschaft veranschaulicht.
// Show how to use LockAllElementsExcept.
// It locks and unlocks all the MyUrls elements
// except urls.
static void LockAllElementsExcept()
{
try
{
// Get the configuration file.
System.Configuration.Configuration config =
ConfigurationManager.OpenExeConfiguration(
ConfigurationUserLevel.None);
// Get the MyUrls section.
UrlsSection myUrlsSection =
config.GetSection("MyUrls") as UrlsSection;
if (myUrlsSection == null)
{
Console.WriteLine("Failed to load UrlsSection.");
}
else
{
// Get MyUrls section LockElements collection.
ConfigurationLockCollection lockElementsExcept =
myUrlsSection.LockAllElementsExcept;
// Get MyUrls section LockElements collection
// enumerator.
IEnumerator lockElementEnum =
lockElementsExcept.GetEnumerator();
// Position the collection index.
lockElementEnum.MoveNext();
if (lockElementsExcept.Contains("urls"))
// Remove the lock on all the ther elements.
lockElementsExcept.Remove("urls");
else
// Add the lock on all the other elements
// but urls element.
lockElementsExcept.Add("urls");
config.Save(ConfigurationSaveMode.Full);
}
}
catch (ConfigurationErrorsException err)
{
Console.WriteLine("[LockAllElementsExcept: {0}]",
err.ToString());
}
}
' Show how to use LockAllElementsExcept.
' It locks and unlocks all the MyUrls elements
' except urls.
Shared Sub LockAllElementsExcept()
Try
' Get the current configuration file.
Dim config _
As System.Configuration.Configuration = _
ConfigurationManager.OpenExeConfiguration( _
ConfigurationUserLevel.None)
' Get the MyUrls section.
Dim myUrlsSection As UrlsSection = _
config.GetSection("MyUrls")
If myUrlsSection Is Nothing Then
Console.WriteLine("Failed to load UrlsSection.")
Else
' Get MyUrls section LockElements collection.
Dim lockElementsExcept _
As ConfigurationLockCollection = _
myUrlsSection.LockAllElementsExcept
' Get MyUrls section LockElements collection
' enumerator.
Dim lockElementEnum As IEnumerator = _
lockElementsExcept.GetEnumerator()
' Position the collection index.
lockElementEnum.MoveNext()
If lockElementsExcept.Contains("urls") Then
' Remove the lock on all the ther elements.
lockElementsExcept.Remove("urls")
' Add the lock on all the other elements
' but urls element.
Else
lockElementsExcept.Add("urls")
End If
config.Save(ConfigurationSaveMode.Full)
End If
Catch err As ConfigurationErrorsException
Console.WriteLine("[LockAllElementsExcept: {0}]", _
err.ToString())
End Try
End Sub
Hinweise
Mit LockAllElementsExcept der -Eigenschaft können Sie alle Elemente gleichzeitig sperren, mit Ausnahme des von Ihnen angegebenen Elements.
Hinweis
Mit LockAllElementsExcept der -Eigenschaft können Sie verhindern, dass die untergeordneten Konfigurationselemente des Elements, auf das Sie die Regel anwenden, geändert werden. Verwenden Sie die LockItem -Eigenschaft, wenn Sie eine allgemeine Sperre für das Element selbst und seine untergeordneten Elemente festlegen möchten.