ConfigurationElement.IsReadOnly ConfigurationElement.IsReadOnly ConfigurationElement.IsReadOnly ConfigurationElement.IsReadOnly Method

Definition

Ruft einen Wert ab, der angibt, ob das ConfigurationElement-Objekt schreibgeschützt ist.Gets a value indicating whether the ConfigurationElement object is read-only.

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.true if the ConfigurationElement object is read-only; otherwise, false.

Beispiele

Im folgenden Beispiel wird die Verwendung der IsReadOnly-Methode gezeigt.The following example shows how to use the IsReadOnly method. Er wird verwendet, für einen benutzerdefinierten Abschnitt, und gibt false.It is used on a custom section and returns 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 'ReadOnlyElements

Hinweise

Das System definiert die Konfigurationselemente, die nicht geändert werden können.The system defines configuration elements that cannot be modified.

Um zu bestimmen, welche Elemente geändert werden können, verwenden die IsReadOnly Methode.To determine which elements can be modified, use the IsReadOnly method.

Gilt für: