Customizing Rendering Extension Parameters in RSReportServer.Config

Można określić rozszerzenie renderujące parametrów w pliku konfiguracyjnym RSReportServer, aby zastąpić domyślne raporty renderowania zachowanie w przypadku raportów, które są uruchamiane Reporting Services serwer raportów. Można zmodyfikować rozszerzenie renderujące parametrów do osiągnięcia następujących celów:

  • Zmienianie sposobu rozszerzenie renderujące nazwa pojawia się na liście eksportu na pasku narzędzi raportu (na przykład, aby zmienić "w sieci Web archiwum"MHTML na "„), lub przetłumaczyć nazwy na inny język.

  • Utwórz wiele wystąpień tego samego rozszerzenie renderujące do obsługi raportu różnych opcji prezentacji (na przykład, pionowej i poziomej trybu wersja rozszerzeń renderowania obrazów).

  • Zmiana domyślnego odwzorowania Parametry rozszerzenia, które mają być używane różne wartości (na przykład rozszerzenie renderujące obrazów TIFF jest używana jako domyślnym formatem danych wyjściowych, można zmodyfikować parametry rozszerzenia, które mają być używane zamiast EMF).

Zmiana rozszerzenie renderujące parametrów ma wpływ tylko na operacje renderowania serwer raportów.Można zastąpić rozszerzenie renderujące ustawienia w oknie podglądu raportu w Konstruktorze raportów.

Określanie rozszerzenie renderujące parametrów w plikach konfiguracyjnych dotyczy rozszerzenie renderujące s globalnie.Ustawienia w plikach konfiguracyjnych są używane zamiast wartości domyślne, za każdym razem, gdy określonego rozszerzenie renderujące jest używany.Jeśli chcesz ustawić rozszerzenie renderujące parametry dla określonego raportu lub uczynić operacji, należy określić informacje o urządzeniach programowo przy użyciu Render(String, String, String%, String%, String%, array<Warning[]%, array<String[]%) Metoda lub określając ustawienia informacji o urządzeniu na adres URL raportu. Aby uzyskać więcej informacji na temat określania ustawień informacji urządzenia dla operacji renderowania i aby wyświetlić pełną listę ustawień urządzenia informacji zobacz Ustawienia informacji o urządzeniu usług Reporting Services.

Znajdowanie i modyfikowanie RSReportServer.config

Ustawienia konfiguracja dla raportu, dane wyjściowe formaty są określane jako rozszerzenie renderujące parametrów w pliku RSReportServer.config.Aby określić rozszerzenie renderujące parametrów w plikach konfiguracyjnych, trzeba znać sposobu definiowania struktury XML, które ustawienia parametrów renderowania.Istnieją dwa struktury XML, które można modyfikować:

  • The OverrideNames element defines the display name and language of the rozszerzenie renderujące.

  • The DeviceInfo XML structure defines the device information settings that are used by a rozszerzenie renderujące. Najbardziej rozszerzenie renderujące parametry są określane jako ustawienia informacji o urządzeniu.

Za pomocą edytora tekstów do modyfikowania pliku.Plik RSReportServer.config znajdują się w folderze \Reporting Services\serwer raportów\Bin.Aby uzyskać więcej informacji na temat modyfikowania konfiguracja plików, zobacz How to: Modify a Reporting Services Configuration File.

Zmiana nazwy wyświetlanej

Nazwa wyświetlana dla rozszerzenie renderujące pojawia się na liście eksportu na pasku narzędzi raportu.Przykładami nazwy wyświetlane domyślne archiwum sieci Web, pliku TIFF i plik programu Acrobat (PDF).Można zastąpić domyślną nazwę wyświetlaną niestandardowej wartości przez określenie OverrideNames element konfiguracja plików. Ponadto, jeśli definiowane są dwa wystąpienia jednego rozszerzenie renderujące, można użyć OverrideNames element do rozróżniania każde wystąpienie na liście eksportu.

Ponieważ nazwy wyświetlane są zlokalizowane, muszą być zestaw Language atrybut, jeśli chcesz zamienić wartość domyślna wyświetlana nazwa wartości niestandardowe. W przeciwnym razie dowolna nazwa, którą określisz zostaną zignorowane.Wartość języka ustawionego musi być prawidłowy dla komputera serwer raportów.Na przykład jeśli serwer raportów jest uruchomiony w systemie operacyjnym francuskie, należy określić "fr-FR" jako wartość atrybut.

Poniższy przykład przedstawia sposób zapewnić unikatową nazwę na w języku angielskim serwer raportów:

<Extension Name="XML" Type="Microsoft.ReportingServices.Rendering.XmlDataRenderer.XmlDataReport,Microsoft.ReportingServices.XmlRendering">
   <OverrideNames>
     <Name Language="en-US">My Custom Display Name for XML Rendering</Name>
   </OverrideNames>
</Extension>

Zmiana ustawienia informacji o urządzenia

Aby zmodyfikować ustawienia domyślne informacji urządzenia, które są używane przez rozszerzenie renderujące, które już są rozmieszczone serwer raportów, należy wpisać DeviceInfo Struktura języka XML w plikach konfiguracyjnych. Każde rozszerzenie renderujące obsługuje ustawienia informacji urządzeń, które są unikatowe dla tego rozszerzenia.Aby wyświetlić pełną listę ustawień urządzenia informacji, zobacz Ustawienia informacji o urządzeniu usług Reporting Services.

W poniższym przykładzie zestawiono ilustracji struktury XML i składni, która modyfikuje domyślne ustawienia obrazu rozszerzenie renderujące:

<Render>
    <Extension Name="IMAGE (EMF)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageReport,Microsoft.ReportingServices.ImageRendering">
        <OverrideNames>
            <Name Language="en-US">Image (EMF)</Name>
        </OverrideNames>
        <Configuration>
            <DeviceInfo>
                <ColorDepth>32</ColorDepth>
                <DpiX>300</DpiX>
                <DpiY>300</DpiY>
                <OutputFormat>EMF</OutputFormat>
            </DeviceInfo>
        </Configuration>
    </Extension>
</Render>

Konfigurowanie wielu wpisów dla rozszerzenie renderujące

Można utworzyć wiele wystąpień tego samego rozszerzenie renderujące do obsługi opcji prezentacji innego raportu.Każde wystąpienie zdefiniowanych przez użytkownika może mieć inną kombinację wartości parametrów.Podczas definiowania nowych instancji istniejące rozszerzenie renderujące, należy wykonać następujące czynności:

  • Określić unikatową nazwę dla rozszerzenia.

    Każde wystąpienie musi mieć unikatową wartość Name atrybut. W poniższym przykładzie użyto nazwy "IMAGE (orientacja pozioma EMF)" i "IMAGE (EMF pionowa)", aby rozróżnić dwa wystąpienia.

    Zachowanie ostrożności przy zmianie nazwy rozszerzenie renderujące, jest już rozmieszczone.Deweloperzy, którzy określić rozszerzeń renderowania programowego za pomocą Nazwa rozszerzenia do identyfikowania, których wystąpienie dla określonego renderowania operacji.Jeśli korzystasz z niestandardowego Reporting Services aplikacje na Twój serwer raportów, upewnij się, że deweloper wie, jeśli modyfikujesz istniejącą nazwę rozszerzenia lub dodać nowe.

  • Określ nazwę wyświetlaną unikatowe, dzięki czemu użytkownicy mogą zrozumieć różnice dla każdego formatu wyjściowego.

    Jeśli konfigurujesz wiele wersja tego samego rozszerzenia można nadać każdej wersja unikatową nazwę przez podanie wartości dla OverrideNames. W przeciwnym razie wszystkie wersje programu z rozszerzeniem pojawi się mają taką samą nazwę, na liście Opcje eksportu na pasku narzędzi raportu.

Poniższy przykład ilustruje sposób użycia domyślny obraz rozszerzenie renderujące (które produkuje TIFF wyjściowego) do wyprowadzenia EMF w trybie pionowa obok drugiego wystąpienie, które generuje raporty w EMF w trybie poziomo.Należy zauważyć, że nazwa każdego rozszerzenia jest unikatowy.Podczas testowania w tym przykładzie, pamiętaj, aby wybrać opcję Pokaż/Ukryj opcje matryc ani przeglądanie szczegółowe łącza (interaktywne funkcje nie działają w rozszerzeniu renderowania obrazów) raportów, które nie zawierają funkcje interaktywne, takie jak:

<Render>
    <Extension Name="IMAGE (EMF Landscape)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageReport,Microsoft.ReportingServices.ImageRendering">
        <OverrideNames>
            <Name Language="en-US">EMF in Landscape Mode</Name>
        </OverrideNames>
        <Configuration>
            <DeviceInfo>
                <OutputFormat>EMF</OutputFormat>
                <PageHeight>8.5in</PageHeight>
                <PageWidth>11in</PageWidth>
            </DeviceInfo>
        </Configuration>
    </Extension>
    <Extension Name="IMAGE (EMF Portrait)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageReport,Microsoft.ReportingServices.ImageRendering">
        <OverrideNames>
            <Name Language="en-US">EMF in Portait Mode</Name>
        </OverrideNames>
        <Configuration>
            <DeviceInfo>
                <OutputFormat>EMF</OutputFormat>
                <PageHeight>11in</PageHeight>
                <PageWidth>8.5in</PageWidth>
            </DeviceInfo>
        </Configuration>
    </Extension>
</Render>