<linkedConfiguration> , element

  • Artykuł

Określa plik konfiguracji do uwzględnienia.

<konfiguracji>
  <Assemblybinding>
    <linkedConfiguration>

Składnia

<linkedConfiguration href="URL of linked configuration file" />

Atrybut

Atrybut opis
Href Atrybut wymagany.

Adres URL pliku konfiguracji do uwzględnienia. Jedynym formatem obsługiwanym dla atrybutu href jest file://. Obsługiwane są pliki lokalne i pliki UNC.

Element nadrzędny

Element opis
<assemblyBinding> , element Określa zasady powiązań zestawów na poziomie konfiguracji.

Elementy podrzędne

Brak

Uwagi

Element <linkedConfiguration> upraszcza obsługę zestawów składników. Jeśli co najmniej jedna aplikacja używa zestawu zawierającego plik konfiguracji znajdujący się w dobrze znanej lokalizacji, ich pliki konfiguracji mogą używać <elementu linkedConfiguration> do uwzględnienia pliku konfiguracji zestawu, a nie duplikowania informacji o konfiguracji. Gdy zestaw składników jest serwisowany, aktualizacja wspólnego pliku konfiguracji udostępnia zaktualizowane informacje o konfiguracji do wszystkich aplikacji korzystających z zestawu.

Uwaga

Element <linkedConfiguration> nie jest obsługiwany w przypadku aplikacji z manifestami równoległymi systemu Windows.

Następujące reguły określają użycie połączonych plików konfiguracji:

  • Ustawienia w dołączonych plikach konfiguracji mają wpływ tylko na zasady powiązania modułu ładującego i są używane tylko przez moduł ładujący. Dołączone pliki konfiguracji mogą mieć ustawienia inne niż zasady powiązania, ale te ustawienia nie mają żadnego wpływu.

  • Jedynym formatem obsługiwanym dla atrybutu href jest file://. Obsługiwane są pliki lokalne i pliki UNC.

  • Nie ma żadnego ograniczenia liczby połączonych konfiguracji na plik konfiguracji.

  • Wszystkie połączone pliki konfiguracji są scalane z jednym plikiem konfiguracji zestawu, podobnie jak zachowanie #include dyrektywy w języku C/C++.

  • Element <linkedConfiguration> jest dozwolony tylko w plikach konfiguracji aplikacji. Jeśli element pojawi się w pliku Machine.config , zostanie zignorowany.

  • Nie ma żadnych ograniczeń dotyczących zawartości dołączonych plików konfiguracji, o ile są one zgodne ze schematem nadrzędnego <elementu assemblyBinding> .

  • Odwołania cykliczne są wykrywane i przerywane. Oznacza to, że jeśli <elementy linkedConfiguration> serii plików konfiguracji tworzą pętlę, pętla jest wykrywana i zatrzymywana.

Przykład

W poniższym przykładzie pokazano, jak dołączyć plik konfiguracji z lokalnego dysku twardego:

<configuration>
  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <linkedConfiguration href="file://c:\Program Files\Contoso\sharedConfig.xml"/>
  </assemblyBinding>
</configuration>

Zobacz też