Anpassa renderingstilläggsparametrar i RSReportServer.Config

Du kan ange renderingstilläggsparametrar i RSReportServer-konfigurationsfilen för att åsidosätta standardrapporteringsbeteende för rapporter som körs på en Reporting Services-rapportserver. Du kan ändra renderingstilläggsparametrar för att uppnå följande mål:

Ändra hur namnet på renderingstillägget visas i Exportlistan i rapportverktygsfältet (till exempel för att ändra "Web archive" till "MHTML"), eller lokalisera namnet till ett annat språk.
Skapa flera instanser av samma renderingstillägg för att stödja olika rapportpresentationsalternativ (till exempel en porträtt- och liggande version av bildrenderingstillägget).
Ändra standardparametrarna för renderingstillägget så att de använder andra värden (till exempel använder Image rendering-tillägget TIFF som standardutdata; du kan ändra tilläggsparametrarna för att använda EMF istället).

Att ändra renderingstilläggets parametrar påverkar endast renderingsoperationer på rapportservern. Du kan inte åsidosätta renderingstilläggsinställningar i rapportförhandsgranskning i Návrhár zostáv.

Att specificera renderingstilläggsparametrar i konfigurationsfilerna påverkar renderingstillägg globalt. Inställningarna i konfigurationsfilerna används istället för standardvärden när en viss renderingsextension används. Om du vill ställa in renderingstilläggsparametrar för en specifik rapport- eller renderingsoperation måste du specificera enhetsinformation programmatiskt med metoden Render eller genom att ange enhetsinformationsinställningar på en rapport-URL. För mer information om att specificera enhetsinformationsinställningar för en renderingsoperation, och för att se den kompletta listan över enhetsinformationsinställningar, se Pass device information settings to rendering extensions.

Hitta och modifiera RSReportServer.config

Konfigurationsinställningar för rapportutdata anges som renderingstilläggsparametrar i RSReportServer.config-filen. För att specificera renderingstilläggsparametrar i konfigurationsfilerna måste du veta hur man definierar XML-strukturer som sätter renderingsparametrar. Det finns två XML-strukturer som du kan ändra:

OverrideNames-elementet definierar visningsnamnet och språket för renderingstillägget.
DeviceInfo XML-strukturen definierar de enhetsinformationsinställningar som används av en renderingstillägg. De flesta renderingstilläggsparametrar specificeras som enhetsinformationsinställningar.

Du kan använda en textredigerare för att ändra filen. Den RSReportServer.config filen finns i \Reporting Services\Report Server\Bin-mappen. För mer information om att modifiera konfigurationsfiler, se Modifiera en Reporting Services konfigurationsfil (RSreportserver.config).

Byt visningsnamn

Visningsnamnet för ett återgivningstillägg visas i listan Export i rapportens verktygsfält. Exempel på standardvisningsnamn inkluderar Web archive, TIFF-fil och Acrobat (PDF)-fil. Du kan ersätta standardnamnet mot ett anpassat värde genom att ange elementet OverrideNames i konfigurationsfilerna. Dessutom, om du definierar två instanser av en enda renderingstillägg, kan du använda elementet OverrideNames för att särskilja varje instans i Export-listan.

Eftersom visningsnamn är lokaliserade måste du sätta attributet Language om du ersätter standardnamnet mot ett eget värde. Annars kommer alla namn du anger att ignoreras. Språkvärdet du sätter måste vara giltigt för rapportserverns dator. Till exempel, om rapportservern körs på ett franskt operativsystem, bör du ange "fr-FR" som attributvärde.

Följande exempel illustrerar hur man anger ett eget namn på en engelsk rapportserver:

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

Ändra enhetsinformationsinställningar

För att ändra standardinställningarna för enhetsinformation som används av ett renderingstillägg som redan har distribuerats på din rapportserver, måste du ange XML-strukturen DeviceInfo i konfigurationsfilerna. Varje renderingstillägg stöder enhetsinformationsinställningar som är unika för det tillägget. För att se den kompletta listan över enhetsinformationsinställningar, se Skicka enhetsinformationsinställningar till renderingstillägg.

Följande exempel ger en illustration av XML-strukturen och syntaxen som ändrar standardinställningarna för bildrenderingstillägget:

<Render>  
    <Extension Name="IMAGE (EMF)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,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>

Konfigurera flera poster för ett renderingstillägg

Du kan skapa flera instanser av samma renderingstillägg för att stödja olika alternativ för rapportpresentation. Varje instans du definierar kan ha en annan kombination av parametervärden. När du definierar nya instanser av ett befintligt renderingstillägg ska du se till att göra följande:

Ange ett unikt namn för tillägget.

Varje instans måste ha ett unikt värde för attributet Name . Följande exempel använder namnen "IMAGE (EMF Landscape)" och "IMAGE (EMF Portrait)" för att skilja mellan de två instanserna.

Var försiktig när du ändrar namnet på ett renderingstillägg som redan är distribuerat. Utvecklare som programmässigt specificerar renderingstillägg använder tilläggsnamnet för att identifiera vilken instans som ska användas för en viss renderingsoperation. Om du kör anpassade Reporting Services-applikationer på din rapportserver, se till att utvecklaren vet om du ändrar ett befintligt tilläggsnamn eller lägger till ett nytt.
Ange ett unikt visningsnamn så att användare kan förstå skillnaderna för varje utdataformat.

Om du konfigurerar flera versioner av samma tillägg kan du ge varje version ett unikt namn genom att ange ett värde för OverrideNames. Annars kommer alla versioner av tillägget att ha samma namn i listan för exportalternativ i rapportverktygsfältet.

Följande exempel illustrerar hur man använder standardtillägget Bildrendering (som ger TIFF-utdata) för att mata ut EMF i porträttläge tillsammans med en andra instans som ger rapporter i EMF i liggande läge. Observera att varje tilläggsnamn är unikt. När du testar detta exempel, kom ihåg att välja rapporter som inte innehåller interaktiva funktioner såsom visa/dölj-alternativ, matriser eller drillthrough-länkar (interaktiva funktioner fungerar inte i bildrenderingstillägget):

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

Feedback

Var den här sidan till hjälp?

Uppdaterades senast 2026-08-24