MS Visio הוא יישום פופולרי המאפשר ליצור מגוון רחב של דיאגרמות כגון תרשימי זרימה, דיאגרמות זרימת נתונים, מודלים של תהליכים עסקיים וכו’. VSDX הוא פורמט הקובץ שבו משתמשת MS Visio לאחסון התרשימים. על מנת להפוך את המניפולציה של VSDX לאוטומטית, מאמר זה מספק לך מדריך בסיסי כיצד ליצור דיאגרמות Visio מאפס ב-C#. יתר על כן, הוא מכסה כיצד להוסיף דפים, צורות וטקסט בדיאגרמות VSDX מתוך יישומי NET.

C# Visio API - הורדה חינם

Aspose.Diagram for .NET הוא API עשיר בתכונות המאפשר לך ליצור, לערוך, להמיר ולעבד דיאגרמות של MS Visio מתוך יישומי ה-.NET שלך. ה-API מקל עליך לתפעל את דיאגרמות VSDX עם מאפיינים ושיטות קלים לשימוש. אתה יכול להוריד את ה-DLL של API או להתקין אותו בתוך יישומי ה-.NET שלך באמצעות NuGet.

Install-Package Aspose.Diagram

צור דיאגרמת Visio VSDX באמצעות C#

קודם כל, בואו ניצור דיאגרמת VSDX ריקה מאפס. להלן השלבים לעשות זאת:

דוגמת הקוד הבאה מראה כיצד ליצור דיאגרמת Visio VSDX ב-C#.

// לדוגמאות מלאות וקבצי נתונים, נא עבור אל https://github.com/aspose-diagram/Aspose.Diagram-for-.NET
// הנתיב לספריית המסמכים.
string dataDir = RunExamples.GetDataDir_Diagrams();

// צור ספרייה אם היא עדיין לא קיימת.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);
// אתחול Visio חדש
Diagram diagram = new Diagram();
dataDir = dataDir + "CreateDiagram_out.vsdx";
// שמור בפורמט VSDX
diagram.Save(dataDir, SaveFileFormat.VSDX);

הוסף מאסטר לדיאגרמת Visio ב-C#

מאסטר משמש להוספת הסטנסיל המכילה אוסף של צורות לשימוש בתרשימים. אם אתה רוצה להוסיף את המאסטר, אתה צריך קובץ סטנסיל VSS ומזהה מאסטר. להלן השלבים להוספת מאסטר לתרשים Visio באמצעות Aspose.Diagram.

דוגמת הקוד הבאה מראה כיצד להוסיף מאסטר לדאגרמת Visio באמצעות C#.

// לדוגמאות מלאות וקבצי נתונים, נא עבור אל https://github.com/aspose-diagram/Aspose.Diagram-for-.NET
// הנתיב לספריית המסמכים.
string dataDir = RunExamples.GetDataDir_Master();

// דיאגרמת עומס
Diagram diagram = new Diagram();

// טען סטנסיל לזרם
string templateFileName = dataDir + "NetApp-FAS-series.vss";
Stream stream = new FileStream(templateFileName, FileMode.Open);

// הוסף מאסטר עם נתיב קובץ סטנסיל ומזהה מאסטר
string masterName = "FAS80xx rear empty";
diagram.AddMaster(templateFileName, 2);

// הוסף מאסטר עם נתיב קובץ סטנסיל ושם מאסטר
diagram.AddMaster(templateFileName, masterName);

// הוסף מאסטר עם זרם קובץ סטנסיל ומזהה מאסטר
diagram.AddMaster(stream, 2);

// מוסיף מאסטר לתרשים מתרשים המקור
Diagram src = new Diagram(templateFileName);
diagram.AddMaster(src, masterName);

// הוסף מאסטר עם זרם קובץ סטנסיל ומזהה מאסטר
diagram.AddMaster(stream, masterName);

// מוסיף צורה עם PinX ו-PinY מוגדרים.
diagram.AddShape(2.0, 2.0, masterName, 0);
diagram.AddShape(6.0, 6.0, masterName, 0);

// מוסיף צורה עם PinX, PinY, רוחב וגובה מוגדרים.
diagram.AddShape(7.0, 3.0, 1.5, 1.5, masterName, 0);

לפרטים נוספים, בקר בכתובת working with master.

הוסף דפים בתרשים Visio ב-C#

דיאגרמות MS Visio מורכבות מעמוד אחד או יותר וכל עמוד מכיל את הדיאגרמות. לכן, לפני הוספת צורה, עליך להוסיף דף באמצעות השלבים הבאים.

  • צור תרשים חדש או טען תרשים קיים באמצעות המחלקה Diagram.
  • בדוק אם הדיאגרמה כבר מכילה עמוד באמצעות המאפיין Diagram.Pages.Count.
  • אם כן, קבל את המזהה של הדף האחרון באמצעות מאפיין Diagram.Pages[index].ID.
  • צור דף חדש באמצעות המחלקה Page והגדר את השם והמזהה שלו.
  • הוסף עמוד לתרשים באמצעות שיטת Diagram.Pages.Add(Page).
  • שמור דיאגרמת VSDX באמצעות שיטת Diagram.Save(Sring fileName, SaveFileFormat.VSDX).

דוגמת הקוד הבאה מראה כיצד להוסיף דף בתרשים Visio VSDX באמצעות C#.

// לדוגמאות מלאות וקבצי נתונים, נא עבור אל https://github.com/aspose-diagram/Aspose.Diagram-for-.NET
// הנתיב לספריית המסמכים.
string dataDir = RunExamples.GetDataDir_VisioPages();

// דיאגרמת עומס
Diagram diagram = new Diagram(dataDir + "Drawing1.vsdx");

// זה מחשב את מזהה העמוד המקסימלי
int max = 0;
if (diagram.Pages.Count != 0)
    max = diagram.Pages[0].ID;

for (int i = 1; i < diagram.Pages.Count; i++)
{
    if (max < diagram.Pages[i].ID)
        max = diagram.Pages[i].ID;
}

// הגדר מזהה דף מקסימלי
int MaxPageId = max;

// אתחול אובייקט עמוד חדש
Page newPage = new Page();
// הגדר שם
newPage.Name = "new page";
// הגדר מזהה עמוד
newPage.ID = MaxPageId + 1;

// או נסה את בונה העמודים
// Page newPage = new Page(MaxPageId + 1);

// הוסף דף ריק חדש
diagram.Pages.Add(newPage);

// שמור דיאגרמה
diagram.Save(dataDir + "InsertBlankPage_out.vsdx", SaveFileFormat.VSDX);

לפרטים נוספים, בקר בכתובת עבודה עם דפים.

צור צורה בתרשים Visio באמצעות C#

צורות הן אבני הבניין של דיאגרמות Visio. MS Visio תומך במגוון רחב של צורות ליצירת דיאגרמות בתחומים שונים. השלבים הבאים מראים כיצד להוסיף צורה בתרשים Visio.

דוגמת הקוד הבאה מראה כיצד להוסיף צורה בתרשים Visio באמצעות C#.

// לדוגמאות מלאות וקבצי נתונים, נא עבור אל https://github.com/aspose-diagram/Aspose.Diagram-for-.NET
// הנתיב לספריית המסמכים.
string dataDir = RunExamples.GetDataDir_Shapes();

// טען תרשים
Diagram diagram = new Diagram(dataDir + "Drawing1.vsdx");
// קבל עמוד לפי שם
Page page = diagram.Pages.GetPage("Page-2");

// הוסף מאסטר עם נתיב קובץ סטנסיל ושם מאסטר
string masterName = "Rectangle";
diagram.AddMaster(dataDir + "Basic Shapes.vss", masterName);
            
// הוספה לאינדקס של עמודים מתחילה מ-0
int PageIndex = 1;
double width = 2, height = 2, pinX = 4.25, pinY = 4.5;
// הוסף צורת מלבן חדשה
long rectangleId = diagram.AddShape(pinX, pinY, width, height, masterName, PageIndex);
            
// הגדר מאפייני צורה 
Shape rectangle = page.Shapes.GetShape(rectangleId);
rectangle.XForm.PinX.Value = 5;
rectangle.XForm.PinY.Value = 5;
rectangle.Type = TypeValue.Shape;
rectangle.Text.Value.Add(new Txt("Aspose Diagram"));
rectangle.TextStyle = diagram.StyleSheets[3];
rectangle.Line.LineColor.Value = "#ff0000";
rectangle.Line.LineWeight.Value = 0.03;
rectangle.Line.Rounding.Value = 0.1;
rectangle.Fill.FillBkgnd.Value = "#ff00ff";
rectangle.Fill.FillForegnd.Value = "#ebf8df";

diagram.Save(dataDir + "AddShape_out.vsdx", SaveFileFormat.VSDX);
Console.WriteLine("Shape has been added.");

לפרטים נוספים, בקר בכתובת עבודה עם צורות.

הוסף צורת טקסט בדף Visio ב-C#

במקרים שונים, עליך להוסיף גם טקסט לדיאגרמות Visio. לשם כך, תוכל לבצע את השלבים הבאים.

דוגמת הקוד הבאה מראה כיצד להוסיף טקסט בתרשים VSDX באמצעות C#.

// לדוגמאות מלאות וקבצי נתונים, נא עבור אל https://github.com/aspose-diagram/Aspose.Diagram-for-.NET
// הנתיב לספריית המסמכים.
string dataDir = RunExamples.GetDataDir_ShapeText();

// צור תרשים חדש
Diagram diagram = new Diagram();
// הגדר פרמטרים והוסף טקסט לדף Visio
double PinX = 1, PinY = 1, Width = 1, Height = 1;                  
diagram.Pages[0].AddText(PinX, PinY, Width, Height, "Test text");
// שמור דיאגרמה 
diagram.Save(dataDir + "InsertTextShape_out.vsdx", SaveFileFormat.VSDX);

לפרטים נוספים, בקר בכתובת עבודה עם טקסט.

סיכום

בפוסט זה, למדת כמה תכונות בסיסיות של Aspose.Diagram עבור .NET ליצירת דיאגרמות Visio VSDX מאפס. דוגמאות הקוד הראו כיצד להוסיף מאסטרים, דפים, צורות וטקסט בדיאגרמות VSDX באמצעות C#. אתה יכול לחקור יותר על ה-API באמצעות תיעוד.

ראה גם