SectionInformation.ConfigSource Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de naam op van het insluitingsbestand waarin de bijbehorende configuratiesectie is gedefinieerd, als een dergelijk bestand bestaat.
public:
property System::String ^ ConfigSource { System::String ^ get(); void set(System::String ^ value); };public string ConfigSource { get; set; }member this.ConfigSource : string with get, setPublic Property ConfigSource As StringWaarde van eigenschap
De naam van het include-bestand waarin de gekoppelde ConfigurationSection is gedefinieerd, als een dergelijk bestand bestaat; anders een lege tekenreeks ("").
Opmerkingen
De ConfigSource eigenschap vertegenwoordigt de waarde van het configSource kenmerk dat is opgegeven voor een ConfigurationSection object dat is gekoppeld aan het SectionInformation object.
Een ConfigurationSection implementatie kan eventueel een afzonderlijk bestand opgeven waarin de configuratie-instellingen voor die sectie worden gedefinieerd. Dit kan op verschillende manieren handig zijn:
Het gebruik van insluitingsbestanden kan resulteren in een meer logische en modulaire structuur voor configuratiebestanden.
Beveiliging en machtigingen voor bestandstoegang kunnen worden gebruikt om de toegang tot secties van configuratie-instellingen te beperken.
Instellingen in een insluitingsbestand dat niet wordt gebruikt tijdens de initialisatie van de toepassing, kunnen worden gewijzigd en opnieuw worden geladen zonder dat een toepassing opnieuw hoeft te worden opgestart.
In het volgende voorbeeld ziet u hoe dit kenmerk wordt gebruikt in een configuratiebestand om op te geven dat de pages sectie is gedefinieerd in een extern include-bestand:
<pages configSource="pages.config"/>
Als een van de instellingen in een configuratie-includebestand de toepassing opnieuw moet opstarten wanneer deze wordt gewijzigd, stelt u de RestartOnExternalChanges eigenschap in op true.
In ASP.NET toepassingen kunt u tijdens runtime toewijzen aan de eigenschap ConfigSource de naam van een alternatief configuratiebestand. In dat geval wordt de inhoud van het bestand standaard overschreven verbindingsreeks informatie die is opgenomen in het Web.config-bestand. Dit gebeurt ook wanneer het alternatieve bestand niet bestaat en wordt gemaakt tijdens runtime. Als het Web.config bestand geen verbindingsreeks informatie bevat, wordt er een lege sectie toegevoegd aan het alternatieve bestand.