Aracılığıyla paylaş


Besleme sağlayıcı paketi bildirim XML formatı

Uyarı

Bazı bilgiler, ticari olarak piyasaya sürülmeden önce önemli ölçüde değiştirilebilen, önceden yayımlanan ürünle ilgilidir. Microsoft, burada sağlanan bilgilerle ilgili olarak açık veya zımni hiçbir garanti vermez.

Pencere Öğeleri Panosu'nda görüntülenebilmesi için Windows akışlarını destekleyen uygulamaların akış sağlayıcılarını sisteme kaydetmesi gerekir. Win32 uygulamaları için şu anda yalnızca paketlenmiş uygulamalar desteklenir ve akış sağlayıcıları kayıt bilgilerini uygulama paketi bildirim dosyasında belirtir. Bu makalede, besleme kaydı için XML biçimi belgelenmiştir. Win32 akış sağlayıcısı için örnek paket bildiriminin kod listesi için Örnek bölümüne bakın.

Uygulama uzantısı

Uygulama paketi bildirim dosyası, Windows uygulamaları için birçok farklı uzantıyı ve özelliği destekler. Uygulama paketi bildirim biçimi, Paket bildirim şeması referansı belgelenen bir dizi şema tarafından tanımlanır. Akış sağlayıcıları kayıt bilgilerini uap3:AppExtension içinde bildirir. Uzantının Name özniteliği "com.microsoft.windows.widgets.feeds" olarak ayarlanmalıdır.

Akış sağlayıcıları uap3:Properties öğesini uap3:AppExtension öğesinin alt öğesi olarak içermelidir. Paket bildirimi şeması, iyi biçimlendirilmiş XML gerektirme dışında uap3:Properties öğesinin yapısını zorlamaz. Bu makalenin geri kalanında, Pencere Öğeleri Panosu'nun bir akış sağlayıcısını başarıyla kaydetmek için beklediği XML biçimi açıklanmaktadır.

<uap3:Extension Category="windows.appExtension">
  <uap3:AppExtension Name="com.microsoft.windows.widgets.feeds" DisplayName="ContosoApp" Id="ContosoApp" PublicFolder="Public">
    <uap3:Properties>
      <!-- Feed provider registration content goes here -->
    </uap3:Properties>
  </uap3:AppExtension>
</uap3:Extension>

Öğe hiyerarşisi

Besleme Sağlayıcı

  Etkinleştirme

    CreateInstance

  Tanımlar

    Tanım

Besleme Sağlayıcı

Akış sağlayıcısı kayıt bilgilerinin kök öğesi.

Özellik Türü Gerekli Açıklama Varsayılan değer
Açıklama String Evet Akış sağlayıcısının kısa bir açıklaması. Mevcut Değil
Ekran Adı String Evet Pencere Öğeleri Panosu'nda görüntülenen akış sağlayıcısının adı. Mevcut Değil
İkon String Evet Pencere Öğeleri Panosu'nda görüntülenen simge görüntü dosyasının paket göreli yolu. Mevcut Değil
Kimlik String Evet Akış sağlayıcısını tanımlayan bir kimlik. Akış sağlayıcısı uygulamaları, her işlem için uygulamanın akış sağlayıcılarından hangilerine başvurulacağını belirlemek veya belirtmek için bu dizeyi kullanır. Bu dize, uygulama bildirim dosyasında tanımlanan tüm akış sağlayıcıları için benzersiz olmalıdır. Mevcut Değil

Etkinleştirme

Akış sağlayıcısı için etkinleştirme bilgilerini belirtir.

CreateInstance

IFeedProvider arabirimini uygulayan Win32 tabanlı akış sağlayıcıları için CreateInstance belirtilmelidir. Sistem, CoCreateInstance çağrısıyla arabirimi etkinleştirir. ClassId özniteliği, IFeedProvider arabirimini uygulayan CreateInstance sunucusu için CLSID'yi belirtir.

Özellik Türü Gerekli Açıklama Varsayılan değer
ClassId GUID Evet Akış sağlayıcısını uygulayan CreateInstance sunucusu için CLSID. Mevcut Değil

Tanımlar

Bir veya daha fazla besleme kaydı için kapsayıcı öğe.

Tanım

Tek bir akış için kaydı temsil eder.

Özellik Türü Gerekli Açıklama Varsayılan değer
Kimlik String Evet Kimlik, akışı tanımlar. Akış sağlayıcısı uygulamaları, her işlem için uygulamanın akışlarından hangilerine başvurulacağını belirlemek veya belirtmek için bu dizeyi kullanır. Bu dize, uygulama bildirim dosyasında tanımlanan tüm akışlar için benzersiz olmalıdır. Mevcut Değil
Ekran Adı String Evet Pencere Öğeleri Panosu'nda görüntülenen akışın adı. Mevcut Değil
Açıklama String Evet Akışın kısa bir açıklaması. Mevcut Değil
ContentUri String Evet Akış içeriğinin alındığı URI. Mevcut Değil
İkon String Evet Pencere Öğeleri Panosu'nda görüntülenen simge görüntü dosyasının paket göreli yolu. Mevcut Değil
WebRequestFilter String Hayı Kaynak isteklerinin, akış sağlayıcısının IFeedResourceProvider uygulamasına yönlendirileceği URL kümesini belirleyen bir web isteği filtreleme dizgisi. Desen, Desenleri Eşleştir bölümünde açıklanan biçim kullanılarak ifade edilir. Kayıttaki filtre dizesi, gerektiğinde Punycode kullanmalıdır. Tüm içerik türleri eşleştirildiğinde yeniden yönlendirilir, bu nedenle filtrenin yalnızca uygulamadaki IFeedResourceProvider aracılığıyla elde edilmesi amaçlanan içeriğe çözümlenmesi gerekir. Mevcut Değil
Hariç Tutulan Bölgeler String Hayı Beslemenin kullanılamaması gereken bölgelerin listesi. Akışlar ExcludedRegions veya ExclusiveRegions belirtebilir, ancak her ikisini de tek bir akış tanımında belirtmemelidir. özniteliğinin değeri, iki karakterli bölge kodunun virgülle ayrılmış bir listesidir. Mevcut Değil
ExclusiveRegions String Hayı Kullanılabilir olması gereken yalnızca belirli bölgelerin akış listesi. Akışlar ExcludedRegions veya ExclusiveRegions belirtebilir, ancak her ikisini de tek akış tanımında belirtmemelidir. özniteliğinin değeri, iki karakterli bölge kodunun virgülle ayrılmış bir listesidir. Mevcut Değil

Ui'ye yönelik öznitelik değerleri için dize değişmez değerleri yerine yerelleştirilmiş kaynakları kullanabilirsiniz. Daha fazla bilgi için bkz. Kullanıcı arabiriminizde ve uygulama paketi bildiriminizde dizeleri yerelleştirme.

Örnek

Aşağıdaki kod örneği, akış paketi bildirim XML biçiminin kullanımını gösterir.

<uap3:AppExtension Name="com.microsoft.windows.widgets.feeds" DisplayName="ContosoApp" Id="ContosoApp" PublicFolder="Public">
  <uap3:Properties>
      <FeedProvider Description="ms-resource:ProviderDescription" Icon="ms-appx:Images\ContosoProviderIcon.png">
          <Activation>
              <CreateInstance ClassId="ECB883FD-3755-4E1C-BECA-D3397A3FF15C" />
          </Activation>
          <Definitions>
              <Definition Id="Contoso_Feed" 
                  DisplayName="ms-resource:FeedDisplayName"                  
                  Description="ms-resource:FeedDescription"
                  ContentUri="https://contoso.com/news"
                  Icon="ms-appx:Images\ContosoFeedIcon.png"
                  WebRequestFilter="https://contoso.com/*/feed/appResource/*"
                  ExcludedRegions="FR,DE,IT">
              </Definition>
          </Definitions>
      </FeedProvider>
  </uap3:Properties>
</uap3:AppExtension>