ConfigurationElement.IsReadOnly Methode
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 einen Wert ab, der angibt, ob das ConfigurationElement schreibgeschützt ist.
public:
virtual bool IsReadOnly();
public virtual bool IsReadOnly ();
abstract member IsReadOnly : unit -> bool
override this.IsReadOnly : unit -> bool
Public Overridable Function IsReadOnly () As Boolean
Gibt zurück
true
, wenn das ConfigurationElement-Objekt schreibgeschützt ist, andernfalls false
.
Beispiele
Im folgenden Beispiel wird die Verwendung der IsReadOnly-Methode gezeigt. Es wird in einem benutzerdefinierten Abschnitt verwendet und gibt zurück false
.
// Show how to use IsReadOnly.
// It loops to see if the elements are read only.
static void ReadOnlyElements()
{
try
{
// Get the configuration file.
System.Configuration.Configuration config =
ConfigurationManager.OpenExeConfiguration(
ConfigurationUserLevel.None);
// Get the MyUrls section.
UrlsSection myUrlsSection =
config.GetSection("MyUrls") as UrlsSection;
UrlsCollection elements = myUrlsSection.Urls;
IEnumerator elemEnum =
elements.GetEnumerator();
int i = 0;
Console.WriteLine(elements.Count.ToString());
while (elemEnum.MoveNext())
{
Console.WriteLine("The element {0} is read only: {1}",
elements[i].Name,
elements[i].IsReadOnly().ToString());
i += 1;
}
}
catch (ConfigurationErrorsException err)
{
Console.WriteLine("[ReadOnlyElements: {0}]",
err.ToString());
}
}
' Show how to use IsReadOnly.
' It loops to see if the elements are read only.
Shared Sub ReadOnlyElements()
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")
Dim elements As UrlsCollection = _
myUrlsSection.Urls
Dim elemEnum As IEnumerator = _
elements.GetEnumerator()
Dim i As Integer = 0
Console.WriteLine(elements.Count.ToString())
While elemEnum.MoveNext()
Console.WriteLine("The element {0} is read only: {1}", _
elements(i).Name, elements(i).IsReadOnly().ToString())
i += 1
End While
Catch err As ConfigurationErrorsException
Console.WriteLine("[ReadOnlyElements: {0}]", _
err.ToString())
End Try
End Sub
Hinweise
Das System definiert Konfigurationselemente, die nicht geändert werden können.
Verwenden Sie die IsReadOnly -Methode, um zu bestimmen, welche Elemente geändert werden können.