एक WPF आवेदन से पीडीएफ उत्पन्न "हर किसी के लिए, कुछ भी नहीं है, और किसी को भी नाराज न होने दें"

कुछ हफ़्ते पहले, परियोजना पर एक पीडीएफ पीढ़ी का कार्य दिखाई दिया।
बेशक, मैं, WPF UI के एक डेवलपर के रूप में, तुरंत C # कोड में सभी पीडीएफ प्राइमेटिव के प्रतिपादन को कोड करने के कठोर दृष्टिकोण का विरोध किया।
और ग्राहक उदाहरण के लिए, HTML से पीडीएफ में एक निश्चित भुगतान कनवर्टर खरीदने का विरोध नहीं कर रहा था।
सब कुछ सरल लगता है - हम HTML मार्कअप के साथ एक लाइन उत्पन्न करते हैं, टेम्पलेट पीढ़ी के लिए डॉटलाइक का उपयोग करते हुए, और कई भुगतान किए गए कन्वर्टर्स में से एक का उपयोग करके इसे पीडीएफ में परिवर्तित करते हैं।
एक पीडीएफ दस्तावेज़ की पृष्ठ संरचना के साथ एकमात्र घात खराब एचटीएमएल संगतता है।
जैसे ही मैंने इस समस्या के समाधान की तलाश में खुदाई शुरू की, एक सहयोगी ने वैकल्पिक समाधान के साथ एक लेख का लिंक साझा किया।
मैंने लेख से सीखा है कि एक एक्सपीएस दस्तावेज़ से पीडीएफ उत्पन्न करना संभव है (यह प्रारूप डब्ल्यूपीएफ फ़्लोडक्वामेंट में समर्थित है)।
इसके अलावा, मुफ्त PDFSharp लाइब्रेरी का उपयोग पीढ़ी के लिए किया गया था।

सूत्रों को GitHub से डाउनलोड किया जा सकता है ।

UPD : यह पहली बार नहीं है जब मैं देख रहा हूँ कि किसी लेख को कैसे जोड़ा जा रहा है (पहले नुकसान प्रकाशन के तुरंत बाद थे और मुख्य सामग्री से संबंधित होने की संभावना नहीं है), जबकि कर्म का विलय। मुझे प्रेरणा, प्रतिक्रिया में दिलचस्पी है। मुश्किल न होने पर असंतुष्ट व्यक्ति किस बात से असंतुष्ट होता है।

त्याग

आपके ध्यान में प्रस्तुत किए गए स्रोत कोड अनुसरण करने के लिए एक उदाहरण नहीं बनाते हैं। लेख को बाहर नहीं निकालने के लिए, मैंने किसी भी डिज़ाइन पैटर्न का पालन नहीं किया। स्रोत कोड एक सरल "कोड बिहाइंड" दृष्टिकोण है। यह सार की धारणा में आसानी के लिए भी किया जाता है, अर्थात। पीडीएफ पीढ़ी पर ध्यान केंद्रित करने के लिए ही। मुझे लगता है कि आप आसानी से कोड के मुख्य टुकड़ों को अपनी परियोजना की संरचना में एकीकृत कर सकते हैं।
इसके अलावा स्रोत में आप DotLiquid टेम्पलेट के लिए डेटा स्रोत के रूप में गतिशील के बड़े पैमाने पर उपयोग में आएंगे। यह भी मुख्य रूप से सादगी और गति के लिए किया गया था। DotLiquid वेबसाइट में आपकी अपनी कक्षाओं को कैसे एनोटेट करना है, इसका वर्णन है ताकि उनका उपयोग टेम्पलेट में किया जा सके। यहां आप अपने स्रोतों को अपनी आवश्यकताओं के अनुसार आसानी से अपना सकते हैं।
खैर, यह भी उल्लेखनीय है कि PDFSharp ने FlowDocument / XPS के छद्म-फ़ॉन्ट के साथ एक समस्या का पता लगाया है। विशेष रूप से, प्रदान किए गए एक्सपीएस अनरेटेड सूची मार्करों को खाली वर्गों के रूप में पीडीएफ में निर्यात किया जाता है। डिबग मोड में, मुझे एक डिबेट आयात / निर्यात त्रुटि के साथ डीबग.एसर्स (...) संदेश प्राप्त हुआ। इस समस्या की अभी तक जांच नहीं की गई है। सूचियों के साथ समस्या एक टेम्पलेट के साथ प्राप्त करना आसान है।

ट्रेनिंग

नीचे आवश्यक जोड़तोड़ की एक सूची है:

• हम संशोधित PDFSharp के बारे में साइट पर जाते हैं और वहां से संकलित असेंबली या स्वयं स्रोत कोड डाउनलोड करते हैं। एक विकल्प PDFSharp संस्करण 1.2 - 1.31, समावेशी है।
• NuGet का उपयोग करके DotLiquid लाइब्रेरी (लेखन के समय संस्करण 1.7.0) स्थापित करें (यदि आपने पहले से ऐसा नहीं किया है तो Nuget स्थापित करें)
• System.Printing और ReachFramework विधानसभाओं के संदर्भ को उस प्रोजेक्ट में जोड़ें जिसमें पीडीएफ जेनरेट किया जाएगा

मुख्य खिड़की

नीचे मुख्य विंडो का लेआउट है।

<Window x:Class="Solution.MainWindow" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" Title="MainWindow" Height="480" Width="640"> <Grid> <Grid.RowDefinitions> <RowDefinition></RowDefinition> <RowDefinition Height="Auto"></RowDefinition> </Grid.RowDefinitions> <FlowDocumentReader x:Name="DocViewer"> <FlowDocument> <FlowDocument.Resources> <Style TargetType="TextBlock"> <Setter Property="FontSize" Value="14"/> <Setter Property="Margin" Value="5"/> </Style> </FlowDocument.Resources> <BlockUIContainer> <Grid> <Grid.ColumnDefinitions> <ColumnDefinition Width="Auto"/> <ColumnDefinition Width="Auto"/> <ColumnDefinition /> </Grid.ColumnDefinitions> <Ellipse Fill="#003481" Width="5" Height="5" Margin="5"/> <TextBlock Text="Title" FontWeight="Bold" Grid.Column="1"/> <TextBlock Text="Description" Grid.Column="2"/> </Grid> </BlockUIContainer> </FlowDocument> </FlowDocumentReader> <StackPanel Grid.Row="1" Orientation="Horizontal"> <Button Click="ParseButton_OnClick">Parse</Button> <Button Click="ButtonBase_OnClick">Print</Button> </StackPanel> </Grid> </Window> 

यहाँ हम एक FlowDocumentReader देखते हैं जो प्रदान किए गए FlowDocument को प्रदर्शित करेगा। मार्कअप में, आप हार्ड-कोडेड फ़्लोडक्वामेंट भी देख सकते हैं, जिसका उपयोग मैं विज़ुअल स्टूडियो में डिज़ाइनर का उपयोग करके टेम्पलेट बनाने के लिए करता हूँ।
आप यह भी देख सकते हैं कि मैं सामान्य नियंत्रण और WPF शैलियों का उपयोग करता हूं। यह PDFs उत्पन्न करने के लिए FlowDocument का उपयोग करने के विशाल बोनस में से एक है। मैं अपने WPF एप्लिकेशन के नियंत्रण और शैली संसाधनों का उपयोग कर सकता हूं। एक मध्यस्थ के रूप में HTML के साथ दृष्टिकोण के लिए, सीएसएस शैलियों और HTML के टुकड़ों की विधानसभा का अलग से समर्थन करना आवश्यक होगा, जिसे अभी भी किसी भी तरह टेम्पलेट में एम्बेड करने की आवश्यकता है।

टेम्पलेट के लिए डेटा संदर्भ

एक डेटा संदर्भ उत्पन्न करने के लिए, मैंने मुख्य विंडो के कोड के पीछे एक निजी विधि जोड़ी, जिसमें DotLiquid का निर्माण किया गया। एक गतिशील वस्तु के लिए हार्ड कोकोड किया गया है।

  private DotLiquid.Hash CreateDocumentContext() { var context = new { Title = "Hello, Habrahabr!", Subtitle = "Experimenting with dotLiquid, FlowDocument and PDFSharp", Steps = new List<dynamic>{ new { Title = "Document Context", Description = "Create data source for dotLiquid Template"}, new { Title = "Rendering", Description = "Load template string and render it into FlowDocument markup with Document Context given"}, new { Title = "Parse markup", Description = "Use XAML Parser to prepare FlowDocument instance"}, new { Title = "Save to XPS", Description = "Save prepared FlowDocument into XPS format"}, new { Title = "Convert XPS to PDF", Description = "Convert XPS to WPF using PDFSharp"}, } }; return DotLiquid.Hash.FromAnonymousObject(context); } 

जैसा कि मैंने अस्वीकरण में लिखा है, यह केवल एक उदाहरण है। एक वास्तविक परियोजना में, आपके पास वास्तविक डीटीओ या व्यूमॉडल के लिए किसी प्रकार का कनवर्टर होना चाहिए।
डॉटलीकाइड पेज पर डेवलपर के मैनुअल में , यह लिखा है कि आप किसी टेम्पलेट में स्ट्रिंग मान प्रदर्शित करने के लिए कुछ मनमाने वर्ग के उदाहरण का उपयोग नहीं कर सकते। यदि आप उदाहरण के लिए, टेम्पलेट में एक डेटटाइम ऑब्जेक्ट का आउटपुट लिखते हैं, तो पैरामीटर के बिना ToString () का आउटपुट प्रदान किए गए दस्तावेज़ में मिल जाएगा। लेकिन अगर आपके द्वारा बनाई गई वस्तु, उदाहरण के लिए, कुछ BlaBlaUser को चालू किया जाता है , तो DotLiquid इसके बजाय एक त्रुटि स्ट्रिंग प्रदर्शित करेगा। और यह, वैसे, बहुत अच्छा है, क्योंकि आप तुरंत उस विशिष्ट स्थान को देखेंगे जहां आपने गलती की थी, जबकि टेम्पलेट अभी भी प्रदान किया जाएगा।

टेम्पलेट

 <FlowDocument xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> <FlowDocument.Resources> <Style TargetType="TextBlock"> <Setter Property="FontSize" Value="14"/> <Setter Property="Margin" Value="5"/> <Setter Property="TextWrapping" Value="Wrap"/> </Style> </FlowDocument.Resources> <Paragraph FontSize="24"> <Bold>{{ Title }}</Bold> </Paragraph> <Paragraph FontSize="16"> {{ Subtitle }} </Paragraph> <Paragraph FontSize="16"> <Bold>Steps to generate PDF:</Bold> </Paragraph> {% for step in Steps -%} <BlockUIContainer> <Grid> <Grid.ColumnDefinitions> <ColumnDefinition Width="Auto"/> <ColumnDefinition Width="Auto"/> <ColumnDefinition /> </Grid.ColumnDefinitions> <Ellipse Fill="#003481" Width="5" Height="5" Margin="5"/> <TextBlock Text="{{ step.Title }}" Foreground="#003481" FontWeight="Bold" Grid.Column="1"/> <TextBlock Text="{{ step.Description }}" Grid.Column="2"/> </Grid> </BlockUIContainer> {% endfor -%} </FlowDocument> 

ध्यान रखें, टेक्स्टब्लॉक। टेक्स्ट विशेषता में सीधे DotLiquid संदर्भ में बाइंडिंग सम्मिलित करने के बजाय, यह नेस्टेड CDATA ब्लॉक का उपयोग करने के लिए सुरक्षित होगा:

 <TextBlock Foreground="#003481" FontWeight="Bold" Grid.Column="1"> <![CDATA[ {{ step.Title }} ]]> </TextBlock> 

यह आपको XML प्रारूप के साथ असंगत पात्रों से बचाएगा।

रेंडरिंग और पार्सिंग फ़्लोडक्लोमेंट

  private void ParseButton_OnClick(object sender, RoutedEventArgs e) { using (var stream = new FileStream("Templates\\report1.lqd", FileMode.Open)) { using (var reader = new StreamReader(stream)) { var templateString = reader.ReadToEnd(); var template = dotTemplate.Parse(templateString); var docContext = CreateDocumentContext(); var docString = template.Render(docContext); DocViewer.Document = (FlowDocument) XamlReader.Parse(docString); } } } 

यहां सब कुछ सरल है। टेम्पलेट के साथ फाइल स्ट्रीम खोलें, टेम्प्लेट संदर्भ बनाएं और फ़्लोडक्वामेंटमेंट मार्कअप रेंडर करें। XamlReader का उपयोग करते हुए, हम परिणामी मार्कअप को पार्स करते हैं और बनाए गए उदाहरण को हमारे FlowDocumentReader में डालते हैं। यदि सब कुछ हमें सूट करता है, तो हम इस दस्तावेज़ के पीडीएफ में रूपांतरण के लिए आगे बढ़ते हैं।

पीडीएफ जनरेशन

  private void ButtonBase_OnClick(object sender, RoutedEventArgs e) { using (var stream = new FileStream("doc.xps", FileMode.Create)) { using (var package = Package.Open(stream, FileMode.Create, FileAccess.ReadWrite)) { using (var xpsDoc = new XpsDocument(package, CompressionOption.Maximum)) { var rsm = new XpsSerializationManager(new XpsPackagingPolicy(xpsDoc), false); var paginator = ((IDocumentPaginatorSource)DocViewer.Document).DocumentPaginator; rsm.SaveAsXaml(paginator); rsm.Commit(); } } stream.Position = 0; var pdfXpsDoc = PdfSharp.Xps.XpsModel.XpsDocument.Open(stream); PdfSharp.Xps.XpsConverter.Convert(pdfXpsDoc, "doc.pdf", 0); } } 

और यहाँ सब कुछ सरल है। एक XPS दस्तावेज़ पैकेज उत्पन्न होता है (जैसा कि आप जानते हैं, XPS बहुत सारे XML और अन्य संसाधनों के साथ एक ज़िप संग्रह है)। पहले हमारे द्वारा प्रदान किया गया FlowDocument XPS पैकेज में सहेजा गया है। (बंद करने से पहले!) XPS पैकेज की स्ट्रीम PDFSharp का उपयोग करके XPS दस्तावेज़ डाउनलोड कर रहा है। उसके बाद, डाउनलोड किए गए एक्सपीएस को पीडीएफ में बदल दिया जाता है।

निष्कर्ष

अंत में, मैं उन लाभों की एक सूची देना चाहूंगा जिन्हें मैंने इस दृष्टिकोण में खुद के लिए पहचाना है।

• नि: शुल्क - हम मुक्त पुस्तकालयों (एमआईटी) की मदद से महत्वपूर्ण व्यावसायिक समस्याओं में से एक को हल करने में कामयाब रहे
• एक मध्यस्थ के रूप में FlowDocument - यह पृष्ठ संरचना और दस्तावेज़ के भीतर WPF नियंत्रण का उपयोग करने की क्षमता के लिए लगभग मूल समर्थन है
• स्टाइलिंग - फ़्लोडीकेंडमेंट के उपयोग के लिए धन्यवाद, शैलियों के साथ डब्ल्यूपीएफ दस्तावेज़ को स्टाइल करना संभव है
• अन्तरक्रियाशीलता - क्योंकि आप WPF नियंत्रणों का उपयोग कर सकते हैं, फिर पीडीएफ में "प्रिंटआउट" से पहले, यदि आवश्यक हो, तो उपयोगकर्ता दस्तावेज़ में कुछ बदलाव और गणना कर सकता है। यहां तक ​​कि इस मामले में बाध्यकारी का उपयोग संभव है (हालांकि इसके साथ कुछ समस्याएं हैं - आपको बाइंडिंग को अपडेट करने के लिए डिस्पैचर के लिए एक किक की आवश्यकता है)।
• विज़ुअल डिज़ाइनर - मैं टेम्पलेट तैयार करते समय सामान्य विज़ुअल स्टूडियो डिज़ाइनर का उपयोग कर सकता हूँ। एकमात्र शिकायत यह है कि DotLiquid फॉर्म "{{someProp}}" के बाइंडर्स XAML मार्कअप के साथ असंगत हैं। आप "{}" की शुरुआत में डालने को दरकिनार कर सकते हैं: <TextBlock पाठ = " {} {{step.Title}}" ... />

आपके ध्यान के लिए धन्यवाद!