ConfigurationElement.LockItem Property
.NET Framework 4.5
Gets or sets a value indicating whether the element is locked.
Assembly: System.Configuration (in System.Configuration.dll)
Property Value
Type: System.Booleantrue if the element is locked; otherwise, false. The default is false.
| Exception | Condition |
|---|---|
| ConfigurationErrorsException | The element has already been locked at a higher configuration level. |
The following example shows how to use the LockItem.
// Show how to set LockItem // It adds a new UrlConfigElement to // the collection. static void LockItem() { string name = "Contoso"; string url = "http://www.contoso.com/"; int port = 8080; try { // Get the current configuration file. System.Configuration.Configuration config = ConfigurationManager.OpenExeConfiguration( ConfigurationUserLevel.None); // Get the MyUrls section. UrlsSection myUrls = config.Sections["MyUrls"] as UrlsSection; // Create the new element. UrlConfigElement newElement = new UrlConfigElement(name, url, port); // Set its lock. newElement.LockItem = true; // Save the new element to the // configuration file. if (!myUrls.ElementInformation.IsLocked) { myUrls.Urls.Add(newElement); config.Save(ConfigurationSaveMode.Full); // This is used to obsolete the cached // section and read the updated // bersion from the configuration file. ConfigurationManager.RefreshSection("MyUrls"); } else Console.WriteLine( "Section was locked, could not update."); } catch (ConfigurationErrorsException e) { Console.WriteLine("[LockItem: {0}]", e.ToString()); } }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.