PrintTicket 建構函式

定義

命名空間:

System.Printing

組件:

ReachFramework.dll

初始化 PrintTicket 類別的新執行個體。

多載

PrintTicket()	初始化 PrintTicket 類別的新執行個體。
PrintTicket(Stream)	使用符合 XML 列印結構描述的 XML 資料流 (包含 PrintTicket 文件)，初始化 PrintTicket 類別的新執行個體。

PrintTicket()

初始化 PrintTicket 類別的新執行個體。

public:
 PrintTicket();

public PrintTicket ();

Public Sub New ()

範例

下列範例示範如何在合併兩個列印票證時使用此建構函式。

/// <summary>
/// Changes the user-default PrintTicket setting of the specified print queue.
/// </summary>
/// <param name="queue">the printer whose user-default PrintTicket setting needs to be changed</param>
static private void ChangePrintTicketSetting(PrintQueue queue)
{
    //
    // Obtain the printer's PrintCapabilities so we can determine whether or not
    // duplexing printing is supported by the printer.
    //
    PrintCapabilities printcap = queue.GetPrintCapabilities();

    //
    // The printer's duplexing capability is returned as a read-only collection of duplexing options
    // that can be supported by the printer. If the collection returned contains the duplexing
    // option we want to set, it means the duplexing option we want to set is supported by the printer,
    // so we can make the user-default PrintTicket setting change.
    //
    if (printcap.DuplexingCapability.Contains(Duplexing.TwoSidedLongEdge))
    {
        //
        // To change the user-default PrintTicket, we can first create a delta PrintTicket with
        // the new duplexing setting.
        //
        PrintTicket deltaTicket = new PrintTicket();
        deltaTicket.Duplexing = Duplexing.TwoSidedLongEdge;

        //
        // Then merge the delta PrintTicket onto the printer's current user-default PrintTicket,
        // and validate the merged PrintTicket to get the new PrintTicket we want to set as the
        // printer's new user-default PrintTicket.
        //
        ValidationResult result = queue.MergeAndValidatePrintTicket(queue.UserPrintTicket, deltaTicket);

        //
        // The duplexing option we want to set could be constrained by other PrintTicket settings
        // or device settings. We can check the validated merged PrintTicket to see whether the
        // the validation process has kept the duplexing option we want to set unchanged.
        //
        if (result.ValidatedPrintTicket.Duplexing == Duplexing.TwoSidedLongEdge)
        {
            //
            // Set the printer's user-default PrintTicket and commit the set operation.
            //
            queue.UserPrintTicket = result.ValidatedPrintTicket;
            queue.Commit();
            Console.WriteLine("PrintTicket new duplexing setting is set on '{0}'.", queue.FullName);
        }
        else
        {
            //
            // The duplexing option we want to set has been changed by the validation process
            // when it was resolving setting constraints.
            //
            Console.WriteLine("PrintTicket new duplexing setting is constrained on '{0}'.", queue.FullName);
        }
    }
    else
    {
        //
        // If the printer doesn't support the duplexing option we want to set, skip it.
        //
        Console.WriteLine("PrintTicket new duplexing setting is not supported on '{0}'.", queue.FullName);
    }
}

''' <summary>
''' Changes the user-default PrintTicket setting of the specified print queue.
''' </summary>
''' <param name="queue">the printer whose user-default PrintTicket setting needs to be changed</param>
Private Shared Sub ChangePrintTicketSetting(ByVal queue As PrintQueue)
    '
    ' Obtain the printer's PrintCapabilities so we can determine whether or not
    ' duplexing printing is supported by the printer.
    '
    Dim printcap As PrintCapabilities = queue.GetPrintCapabilities()

    '
    ' The printer's duplexing capability is returned as a read-only collection of duplexing options
    ' that can be supported by the printer. If the collection returned contains the duplexing
    ' option we want to set, it means the duplexing option we want to set is supported by the printer,
    ' so we can make the user-default PrintTicket setting change.
    '
    If printcap.DuplexingCapability.Contains(Duplexing.TwoSidedLongEdge) Then
        '
        ' To change the user-default PrintTicket, we can first create a delta PrintTicket with
        ' the new duplexing setting.
        '
        Dim deltaTicket As New PrintTicket()
        deltaTicket.Duplexing = Duplexing.TwoSidedLongEdge

        '
        ' Then merge the delta PrintTicket onto the printer's current user-default PrintTicket,
        ' and validate the merged PrintTicket to get the new PrintTicket we want to set as the
        ' printer's new user-default PrintTicket.
        '
        Dim result As ValidationResult = queue.MergeAndValidatePrintTicket(queue.UserPrintTicket, deltaTicket)

        '
        ' The duplexing option we want to set could be constrained by other PrintTicket settings
        ' or device settings. We can check the validated merged PrintTicket to see whether the
        ' the validation process has kept the duplexing option we want to set unchanged.
        '
        If result.ValidatedPrintTicket.Duplexing = Duplexing.TwoSidedLongEdge Then
            '
            ' Set the printer's user-default PrintTicket and commit the set operation.
            '
            queue.UserPrintTicket = result.ValidatedPrintTicket
            queue.Commit()
            Console.WriteLine("PrintTicket new duplexing setting is set on '{0}'.", queue.FullName)
        Else
            '
            ' The duplexing option we want to set has been changed by the validation process
            ' when it was resolving setting constraints.
            '
            Console.WriteLine("PrintTicket new duplexing setting is constrained on '{0}'.", queue.FullName)
        End If
    Else
        '
        ' If the printer doesn't support the duplexing option we want to set, skip it.
        '
        Console.WriteLine("PrintTicket new duplexing setting is not supported on '{0}'.", queue.FullName)
    End If
End Sub

PrintTicket(Stream)

使用符合 XML 列印結構描述的 XML 資料流 (包含 PrintTicket 文件)，初始化 PrintTicket 類別的新執行個體。

public:
 PrintTicket(System::IO::Stream ^ xmlStream);

public PrintTicket (System.IO.Stream xmlStream);

new System.Printing.PrintTicket : System.IO.Stream -> System.Printing.PrintTicket

Public Sub New (xmlStream As Stream)

參數

xmlStream

Stream

描述列印工作並且符合列印結構描述的 XML 資料流。

例外狀況

ArgumentNullException

xmlStream 為 null。

FormatException

xmlStream 不是有效的 XML。

備註

建構函式不會將數據流的讀寫位置重設為其原始位置。 因此，您應該在呼叫建構函式之後立即重設它。

整個 PrintTicket 檔會儲存在 物件的非公用欄位中，包括其中 XML 元素，表示類別之任何公用屬性 PrintTicket 未表示的較不通用功能。 事實上，如果產生 PrintTicket 檔的驅動程式使用 列印架構的私人延伸模組，該私用定義的標記也會儲存為非公用 PrintTicket 檔的一部分。

如果有任何，則檔的私人部分不會由建構函式驗證，但會驗證所有 列印架構定義的元件，包括類別之任何公用屬性未表示的部分 PrintTicket 。 因此， FormatException 即使對應至公用屬性的所有 XML 標記都有效，也可能擲回 。

當的任何屬性 PrintTicket 寫入時，此非公用 PrintTicket 檔也會變更。

這是和 SaveTo 方法所GetXmlStream傳回的非公用 PrintTicket 檔。

另請參閱

• 列印架構