# Rozpoczęcie Pracy z IronWord
## IronWord: Biblioteka Dokumentów Word dla .NET
**IronWord** to biblioteka dokumentów Word opracowana przez Iron Software. IronWord doskonali się w zapewnianiu solidnej funkcjonalności do pracy z dokumentami Word w aplikacjach .NET.
- Ładowanie, manipulowanie i zapisywanie dokumentów Word i Docx.
- `PageSetup`: Konfigurowanie rozmiaru papieru, orientacji strony, marginesów i koloru tła.
- `TextRun`: Obsługa treści tekstu, stylów, dzielenie, dodawanie tekstu i dodawanie obrazów.
- `TextStyle`: Zarządzanie czcionką, rozmiarem, kolorem, pogrubieniem, kursywą, przekreśleniem, podkreśleniem, indeksy górne i dolne.
- `Paragraph`: Dodawanie fragmentów tekstu, obrazów, kształtów, ustawianie stylów, wyrównania, punktorów i list numerowanych.
- `Table`: Manipulowanie strukturą tabeli, w tym dodawanie wierszy, pobieranie i ustawianie wartości komórek, usuwanie wierszy, scalanie komórek i nie tylko.
- `Image`: Ładowanie obrazów z plików lub strumieni, ustawianie zawijania tekstu, przesunięcia pozycji, szerokości, wysokości i innych właściwości.
- `Shape`: Ustawianie zawijania tekstu, przesunięcia pozycji, szerokości, wysokości, rodzaju kształtu i rotacji.
<div class="hsg-featured-snippet">
<h2>Biblioteka C# dotycząca dokumentów Word dla .NET</h2>
<ol>
<li><a class="js-modal-open" data-modal-id="trial-license-after-download" href="https://www.nuget.org/packages/IronWord/">Pobierz bibliotekę C# do obsługi dokumentów DOCX</a></li>
<li>Tworzenie i modyfikowanie dokumentów Word i DOCX</li>
<li>Dodawanie struktur dokumentu takich jak akapity, sekcje i tabele</li>
<li>Dodawanie elementów dokumentu takich jak przebiegi tekstu, obrazy i kształty</li>
<li>Stylizowanie elementów dokumentu z łatwością</li>
</ol>
</div>
## Instalacja
### Biblioteka IronWord
Instalacja IronWord jest szybka i prosta. Możesz zainstalować pakiet używając NuGet z następującą komendą:
```shell
:ProductInstall
```
Alternatywnie, pobierz bezpośrednio z [oficjalnej strony NuGet IronWord](https://www.nuget.org/packages/IronWord).
Po zainstalowaniu możesz rozpocząć, dodając `using IronWord;` na początku pliku kodu C#.
## Stosowanie klucza licencyjnego
Następnie zastosuj ważną licencję lub klucz próbny do IronWord, przypisując klucz licencyjny do właściwości `LicenseKey` klasy `License`. Dołącz następujący kod zaraz po instrukcji importu, zanim użyjesz jakichkolwiek metod IronWord:
```csharp
using IronWord;
// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";
```
## Przykłady kodu
Przeanalizujmy teraz kilka przykładów kodu i dostępnych funkcji.
[[i:(Plik DOCX wytworzony przez IronWord, gdy otwarty w pewnej wersji Microsoft Word, może być w **trybie zgodności**, co powoduje niedostępność niektórych stylów. Aby przekonwertować dokument Word poza trybem zgodności)]]
1. Wybierz 'Plik' > 'Informacje' i kliknij "Konwertuj."
2. Otrzymasz komunikat informujący, że twój dokument zostanie zaktualizowany do najnowszego formatu pliku. Kliknij "OK."
## Tworzenie dokumentów Word i Docx
Utwórz dokument Word, instancjując klasę `WordDocument` za pomocą jednego z jej konstruktorów. Następnie użyj metody `SaveAs`, aby wyeksportować dokument Word. Przykład:
```csharp
using IronWord;
class Program
{
static void Main()
{
// Create a new Word document
var document = new WordDocument();
// Save the document as a .docx file
document.SaveAs("example.docx");
}
}
```
## Dodaj obraz
Obrazu nie można dodać samodzielnie; zamiast tego powinno być dodane do jednej z struktur dokumentu, takich jak `Paragraph`, `TableCell` lub `Section`. Użyj metody `AddImage`, aby dodać obraz. Przykład:
```csharp
using IronWord;
using System.Drawing;
class Program
{
static void Main()
{
var document = new WordDocument();
var section = document.Sections.Add();
// Add an image to a paragraph
var paragraph = section.Paragraphs.Add();
paragraph.AddImage("path/to/image.jpg", new Rectangle(0, 0, 100, 100));
document.SaveAs("example_with_image.docx");
}
}
```
## Dodaj Tabelę
Dodanie tabeli wymaga utworzenia tabeli, wierszy, kolumn oraz komórek tabeli. To umożliwia znaczące możliwości konfiguracji, ponieważ każda komórka może mieć różne style. Przykład:
```csharp
using IronWord;
class Program
{
static void Main()
{
var document = new WordDocument();
var section = document.Sections.Add();
var table = section.Tables.Add(3, 3); // 3x3 table
// Iterate over cells and set their content
for (int i = 0; i < table.Rows.Count; i++)
{
for (int j = 0; j < table.Rows[i].Cells.Count; j++)
{
table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}");
}
}
document.SaveAs("example_with_table.docx");
}
}
```
## Licencjonowanie i wsparcie dostępne
**IronWord** jest płatną biblioteką; jednakże, bezpłatne licencje próbne są dostępne [tutaj](trial-license).
Aby uzyskać więcej informacji o Iron Software, odwiedź naszą stronę internetową: [https://ironsoftware.com/](https://ironsoftware.com/). Aby uzyskać więcej wsparcia i zapytań, proszę [skontaktować się z naszym zespołem](https://www.ironsoftware.com/csharp/word/docs/#live-chat-support).
### Wsparcie od Iron Software
W przypadku ogólnego wsparcia i pytań technicznych, prosimy o kontakt mailowy na adres: [support@ironsoftware.com](mailto:support@ironsoftware.com)
IronWord to biblioteka dokumentów Word opracowana przez Iron Software. IronWord doskonali się w zapewnianiu solidnej funkcjonalności do pracy z dokumentami Word w aplikacjach .NET.
Ładowanie, manipulowanie i zapisywanie dokumentów Word i Docx.
PageSetup: Konfigurowanie rozmiaru papieru, orientacji strony, marginesów i koloru tła.
TextRun: Obsługa treści tekstu, stylów, dzielenie, dodawanie tekstu i dodawanie obrazów.
Paragraph: Dodawanie fragmentów tekstu, obrazów, kształtów, ustawianie stylów, wyrównania, punktorów i list numerowanych.
Table: Manipulowanie strukturą tabeli, w tym dodawanie wierszy, pobieranie i ustawianie wartości komórek, usuwanie wierszy, scalanie komórek i nie tylko.
Image: Ładowanie obrazów z plików lub strumieni, ustawianie zawijania tekstu, przesunięcia pozycji, szerokości, wysokości i innych właściwości.
Shape: Ustawianie zawijania tekstu, przesunięcia pozycji, szerokości, wysokości, rodzaju kształtu i rotacji.
Po zainstalowaniu możesz rozpocząć, dodając using IronWord; na początku pliku kodu C#.
Stosowanie klucza licencyjnego
Następnie zastosuj ważną licencję lub klucz próbny do IronWord, przypisując klucz licencyjny do właściwości LicenseKey klasy License. Dołącz następujący kod zaraz po instrukcji importu, zanim użyjesz jakichkolwiek metod IronWord:
using IronWord;// Assign your license keyLicense.LicenseKey = "YOUR_LICENSE_KEY_HERE";
using IronWord;
// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";
ImportsIronWord' Assign your license keyLicense.LicenseKey = "YOUR_LICENSE_KEY_HERE"
Imports IronWord
' Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"
Przykłady kodu
Przeanalizujmy teraz kilka przykładów kodu i dostępnych funkcji.
Zwróć uwagę: Plik DOCX wytworzony przez IronWord, gdy otwarty w pewnej wersji Microsoft Word, może być w trybie zgodności, co powoduje niedostępność niektórych stylów. Aby przekonwertować dokument Word poza trybem zgodności
Wybierz 'Plik' > 'Informacje' i kliknij "Konwertuj."
Otrzymasz komunikat informujący, że twój dokument zostanie zaktualizowany do najnowszego formatu pliku. Kliknij "OK."
Tworzenie dokumentów Word i Docx
Utwórz dokument Word, instancjując klasę WordDocument za pomocą jednego z jej konstruktorów. Następnie użyj metody SaveAs, aby wyeksportować dokument Word. Przykład:
using IronWord;class Program{ static voidMain() { // Create a new Word document var document = new WordDocument(); // Save the document as a .docx file document.SaveAs("example.docx"); }}
using IronWord;
class Program
{
static void Main()
{
// Create a new Word document
var document = new WordDocument();
// Save the document as a .docx file
document.SaveAs("example.docx");
}
}
ImportsIronWordFriend Class ProgramShared Sub Main() ' Create a new Word document Dim document = New WordDocument() ' Save the document as a .docx file document.SaveAs("example.docx") End SubEnd Class
Imports IronWord
Friend Class Program
Shared Sub Main()
' Create a new Word document
Dim document = New WordDocument()
' Save the document as a .docx file
document.SaveAs("example.docx")
End Sub
End Class
Dodaj obraz
Obrazu nie można dodać samodzielnie; zamiast tego powinno być dodane do jednej z struktur dokumentu, takich jak Paragraph, TableCell lub Section. Użyj metody AddImage, aby dodać obraz. Przykład:
using IronWord;using System.Drawing;class Program{ static voidMain() { var document = new WordDocument(); var section = document.Sections.Add(); // Add an image to a paragraph var paragraph = section.Paragraphs.Add(); paragraph.AddImage("path/to/image.jpg", new Rectangle(0, 0, 100, 100)); document.SaveAs("example_with_image.docx"); }}
using IronWord;
using System.Drawing;
class Program
{
static void Main()
{
var document = new WordDocument();
var section = document.Sections.Add();
// Add an image to a paragraph
var paragraph = section.Paragraphs.Add();
paragraph.AddImage("path/to/image.jpg", new Rectangle(0, 0, 100, 100));
document.SaveAs("example_with_image.docx");
}
}
ImportsIronWordImportsSystem.DrawingFriend Class ProgramShared Sub Main() Dim document = New WordDocument() Dim section = document.Sections.Add() ' Add an image to a paragraph Dim paragraph = section.Paragraphs.Add() paragraph.AddImage("path/to/image.jpg", New Rectangle(0, 0, 100, 100)) document.SaveAs("example_with_image.docx") End SubEnd Class
Imports IronWord
Imports System.Drawing
Friend Class Program
Shared Sub Main()
Dim document = New WordDocument()
Dim section = document.Sections.Add()
' Add an image to a paragraph
Dim paragraph = section.Paragraphs.Add()
paragraph.AddImage("path/to/image.jpg", New Rectangle(0, 0, 100, 100))
document.SaveAs("example_with_image.docx")
End Sub
End Class
Dodaj Tabelę
Dodanie tabeli wymaga utworzenia tabeli, wierszy, kolumn oraz komórek tabeli. To umożliwia znaczące możliwości konfiguracji, ponieważ każda komórka może mieć różne style. Przykład:
using IronWord;class Program{ static voidMain() { var document = new WordDocument(); var section = document.Sections.Add(); var table = section.Tables.Add(3, 3); // 3x3 table // Iterate over cells and set their content for (int i = 0; i < table.Rows.Count; i++) { for (int j = 0; j < table.Rows[i].Cells.Count; j++) { table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}"); } } document.SaveAs("example_with_table.docx"); }}
using IronWord;
class Program
{
static void Main()
{
var document = new WordDocument();
var section = document.Sections.Add();
var table = section.Tables.Add(3, 3); // 3x3 table
// Iterate over cells and set their content
for (int i = 0; i < table.Rows.Count; i++)
{
for (int j = 0; j < table.Rows[i].Cells.Count; j++)
{
table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}");
}
}
document.SaveAs("example_with_table.docx");
}
}
ImportsIronWordFriend Class ProgramShared Sub Main() Dim document = New WordDocument() Dim section = document.Sections.Add() Dim table = section.Tables.Add(3, 3) ' 3x3 table ' Iterate over cells and set their content For i AsInteger = 0 To table.Rows.Count - 1 Dim j AsInteger = 0 Do While j < table.Rows(i).Cells.Count table.Rows(i).Cells(j).Paragraphs.Add().AppendText($"Cell {i+1},{j+1}") j += 1 Loop Next i document.SaveAs("example_with_table.docx") End SubEnd Class
Imports IronWord
Friend Class Program
Shared Sub Main()
Dim document = New WordDocument()
Dim section = document.Sections.Add()
Dim table = section.Tables.Add(3, 3) ' 3x3 table
' Iterate over cells and set their content
For i As Integer = 0 To table.Rows.Count - 1
Dim j As Integer = 0
Do While j < table.Rows(i).Cells.Count
table.Rows(i).Cells(j).Paragraphs.Add().AppendText($"Cell {i+1},{j+1}")
j += 1
Loop
Next i
document.SaveAs("example_with_table.docx")
End Sub
End Class
Licencjonowanie i wsparcie dostępne
IronWord jest płatną biblioteką; jednakże, bezpłatne licencje próbne są dostępne tutaj.
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.