ReportViewer.SetPageSettings-Methode

Legt die Seiteneinstellungen fest, die zum Drucken des aktuellen Berichts im ReportViewer-Steuerelement oder zum Anzeigen im Drucklayoutmodus verwendet werden.

Namespace:  Microsoft.Reporting.WinForms
Assembly:  Microsoft.ReportViewer.WinForms (in Microsoft.ReportViewer.WinForms.dll)

Syntax

'Declaration
Public Sub SetPageSettings ( _
    pageSettings As PageSettings _
)
'Usage
Dim instance As ReportViewer
Dim pageSettings As PageSettings

instance.SetPageSettings(pageSettings)
public void SetPageSettings(
    PageSettings pageSettings
)
public:
void SetPageSettings(
    PageSettings^ pageSettings
)
member SetPageSettings : 
        pageSettings:PageSettings -> unit 
public function SetPageSettings(
    pageSettings : PageSettings
)

Parameter

Hinweise

Standardmäßig verwendet das ReportViewer-Steuerelement beim Drucken des aktuellen Berichts oder beim Anzeigen des aktuellen Berichts im Drucklayoutmodus die in der Berichtsdefinition angegebenen Seiteneinstellungen. Verwenden Sie diese Methode zum Ändern der Seiteneinstellungen für den aktuellen Bericht (nicht die aktuelle Seite), z.B. Ränder und Papierformat. Diese Methode überprüft die Werte für den Rand und das Papierformat im pageSettings-Parameter. Beachten Sie, dass sich die Änderung nur auf den aktuellen Bericht im ReportViewer-Steuerelement auswirkt und nicht für seinen übergeordneten Bericht oder die darüber zugänglichen Drillthroughberichte gilt.

Das ReportViewer-Steuerelement verwendet die pageSettings**.PrinterSettings-Eigenschaft zum Initialisieren des Dialogfelds Drucken, aber es führt keine Überprüfung der pageSettings.PrinterSettings-Eigenschaft durch. Die Druckereinstellungen in pageSettings.PrinterSettings** wirken sich auf alle Berichte aus, die im ReportViewer-Steuerelement angezeigt werden. Wenn pageSettings**.PrinterSettings** den Wert nullein NULL-Verweis (Nothing in Visual Basic) hat, bleiben die bestehenden Druckereinstellungen unverändert.

Falls sich das ReportViewer-Steuerelement beim Aufrufen dieser Methode im Drucklayoutmodus befindet, bricht es alle momentan ausgeführten Renderingvorgänge für Berichte ab und rendert den Bericht unverzüglich neu.

Siehe auch

Verweis

ReportViewer Klasse

Microsoft.Reporting.WinForms-Namespace