--- title: "Wstaw pola w C#" --- Istnieje kilka różnych sposobów wstawiania pól do dokumentu: * przy użyciu [DocumentBuilder](https://reference.aspose.com/words/net/aspose.words/documentbuilder/) * przy użyciu [FieldBuilder](https://reference.aspose.com/words/net/aspose.words.fields/fieldbuilder/) * przy użyciu [Aspose.Words Document Object Model (DOM)](/words/pl/net/aspose-words-document-object-model/) W tym artykule przyjrzymy się każdemu sposobowi bardziej szczegółowo i przeanalizujemy, jak wstawić określone pola za pomocą tych opcji. ## Wstawianie pól do dokumentu przy użyciu narzędzia DocumentBuilder W Aspose.Words metoda [InsertField](https://reference.aspose.com/words/net/aspose.words/documentbuilder/insertfield/) służy do wstawiania nowych pól do dokumentu. Pierwszy parametr akceptuje pełny kod pola, które ma zostać wstawione. Drugi parametr jest opcjonalny i umożliwia ręczne ustawienie wyniku pola. Jeśli nie zostanie to podane, pole zostanie automatycznie zaktualizowane. Do tego parametru można przekazać wartość null lub pusty, aby wstawić pole z wartością pustego pola. Jeśli nie masz pewności co do składni konkretnego kodu pola, utwórz najpierw pole w formacie Microsoft Word i przełącz się, aby zobaczyć jego kod pola. ``` Jeśli kod pola zawiera parametr zawierający spację, należy go ująć w znaki mowy. W przeciwnym razie pole zarówno w Microsoft Word, jak i Aspose.Words może nie działać zgodnie z oczekiwaniami, ponieważ parametr jest traktowany przez oba jako obcięty. ``` Poniższy przykład kodu pokazuje, jak wstawić pole scalania do dokumentu przy użyciu **DocumentBuilder**: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertField-InsertField.cs" >}} Tę samą technikę stosuje się do wstawiania pól zagnieżdżonych w innych polach. Poniższy przykład kodu pokazuje, jak wstawić pola zagnieżdżone w innym polu za pomocą **DocumentBuilder**: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertNestedFields-InsertNestedFields.cs" >}} ### Określ ustawienia regionalne na poziomie pola Identyfikator języka to standardowy międzynarodowy skrót numeryczny języka danego kraju lub regionu geograficznego. W Aspose.Words można określić ustawienia regionalne na poziomie pola przy użyciu właściwości [LocaleId](https://reference.aspose.com/words/net/aspose.words.fields/field/localeid/), która pobiera lub ustawia identyfikator ustawień regionalnych pola. Poniższy przykład kodu pokazuje, jak używać tej opcji: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-SpecifylocaleAtFieldlevel-SpecifylocaleAtFieldlevel.cs" >}} ### Wstaw niewpisane/puste pole Jeśli chcesz wstawić niewpisane/puste pola ({}), tak jak pozwala na to Microsoft Word, możesz użyć metody [InsertField](https://reference.aspose.com/words/net/aspose.words/documentbuilder/insertfield/) z parametrem [FieldType.FieldNone](https://reference.aspose.com/words/net/aspose.words.fields/fieldtype/). Aby wstawić pole do dokumentu Word, możesz nacisnąć kombinację klawiszy "Ctrl + F9". Poniższy przykład kodu pokazuje, jak wstawić puste pole do dokumentu: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertFieldNone-InsertFieldNone.cs" >}} ## Wstawianie pól do dokumentu za pomocą FieldBuilder Alternatywnym sposobem wstawiania pól w Aspose.Words jest klasa [FieldBuilder](https://reference.aspose.com/words/net/aspose.words.fields/fieldbuilder/). Zapewnia płynny interfejs do określania przełączników pól i wartości argumentów jako tekstu, węzłów, a nawet pól zagnieżdżonych. Poniższy przykład kodu pokazuje, jak wstawić pole do dokumentu za pomocą **FieldBuilder**: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertFieldUsingFieldBuilder.cs" >}} ## Wstawianie pól za pomocą DOM Za pomocą [Aspose.Words Document Object Model (DOM)](/words/pl/net/aspose-words-document-object-model/) możesz także wstawiać różne typy pól. W tej sekcji przyjrzymy się kilku przykładom. ### Wstawianie pola scalania do dokumentu za pomocą DOM Pole `MERGEFIELD` w dokumencie Word może być reprezentowane przez klasę [FieldMergeField](https://reference.aspose.com/words/net/aspose.words.fields/fieldmergefield/). Klasę **FieldMergeField** można wykorzystać do wykonania następujących operacji: - określ nazwę pola scalania - określ formatowanie pola scalania - określ tekst znajdujący się pomiędzy separatorem pola a końcem pola scalającego - określ tekst, który ma zostać wstawiony po polu scalającym, jeśli pole nie jest puste - określ tekst, który ma zostać wstawiony przed polem scalania, jeśli pole nie jest puste ``` Aby uzyskać więcej informacji, zobacz klasę [FieldMergeField](https://reference.aspose.com/words/net/aspose.words.fields/fieldmergefield/) API. ``` Poniższy przykład kodu pokazuje, jak dodać pole `MERGE` za pomocą formatu DOM do akapitu w dokumencie: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertMergeFieldUsingDOM-InsertMergeFieldUsingDOM.cs" >}} ### Wstawianie pola Mail Merge `ADDRESSBLOCK` do dokumentu przy użyciu formatu DOM Pole `ADDRESSBLOCK` służy do wstawienia bloku adresu Mail Merge do dokumentu Word. Pole `ADDRESSBLOCK` w dokumencie Word może być reprezentowane przez klasę [FieldAddressBlock](https://reference.aspose.com/words/net/aspose.words.fields/fieldaddressblock/). Za pomocą klasy **FieldAddressBlock** możesz wykonać następujące operacje: - określ, czy w polu ma być zawarta nazwa kraju/regionu - określ, czy adres ma być formatowany zgodnie z krajem/regionem odbiorcy zgodnie z definicją POST*CODE (Powszechny Związek Pocztowy 2006) - podaj nazwę wykluczonego kraju/regionu - określ format nazwy i adresu - określ identyfikator języka używany do formatowania adresu ``` Aby uzyskać więcej informacji, zobacz klasę [FieldAddressBlock](https://reference.aspose.com/words/net/aspose.words.fields/fieldaddressblock/) API. ``` Poniższy przykład kodu pokazuje, jak dodać pole Mail Merge `ADDRESSBLOCK` przy użyciu formatu DOM do akapitu w dokumencie: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertMailMergeAddressBlockFieldUsingDOM-InsertMailMergeAddressBlockFieldUsingDOM.cs" >}} ### Wstawianie pola `ADVANCE` do dokumentu bez użycia narzędzia DocumentBuilder Pole `ADVANCE` służy do przesuwania kolejnego tekstu w wierszu w lewo, w prawo, w górę lub w dół. Pole `ADVANCE` w dokumencie Word może być reprezentowane przez klasę [FieldAdvance](https://reference.aspose.com/words/net/aspose.words.fields/fieldadvance/). Klasę **FieldAdvance** można wykorzystać do wykonania następujących operacji: - określ liczbę punktów, o jaką tekst następujący po polu powinien zostać odsunięty w pionie od górnej krawędzi strony - określić liczbę punktów, o jaką tekst następujący za polem powinien zostać przesunięty poziomo od lewej krawędzi kolumny, ramki lub pola tekstowego - określ liczbę punktów, o jaką tekst następujący po polu ma zostać przesunięty w lewo, w prawo, w górę lub w dół ``` Aby uzyskać więcej informacji, zobacz klasę [FieldAdvance](https://reference.aspose.com/words/net/aspose.words.fields/fieldadvance/) API. ``` Poniższy przykład kodu pokazuje, jak dodać pole `ADVANCE` za pomocą formatu DOM do akapitu w dokumencie: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertAdvanceFieldWithOutDocumentBuilder-InsertAdvanceFieldWithOutDocumentBuilder.cs" >}} ### Wstawianie pola `ASK` do dokumentu bez użycia narzędzia DocumentBuilder Pole `ASK` służy do monitowania użytkownika o tekst do przypisania do zakładki w dokumencie programu Word. Pole `ASK` w dokumencie Word może być reprezentowane przez klasę [FieldAsk](https://reference.aspose.com/words/net/aspose.words.fields/fieldask/). Klasę **FieldAsk** można wykorzystać do wykonania następujących operacji: - podaj nazwę zakładki - określ domyślną reakcję użytkownika (wartość początkowa zawarta w oknie zachęty) - określ, czy odpowiedź użytkownika powinna być odbierana raz na operację mail merge - określ tekst zachęty (tytuł okna podpowiedzi) ``` Aby uzyskać więcej informacji, zobacz klasę [FieldAsk](https://reference.aspose.com/words/net/aspose.words.fields/fieldask/) API. ``` Poniższy przykład kodu pokazuje, jak dodać pole `ASK` za pomocą formatu DOM do akapitu w dokumencie: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertASKFieldWithOutDocumentBuilder-InsertASKFieldWithOutDocumentBuilder.cs" >}} ### Wstawianie pola `AUTHOR` do dokumentu bez użycia narzędzia DocumentBuilder Pole `AUTHOR` służy do podania nazwiska autora Dokumentu na podstawie właściwości `Document`. Pole `AUTHOR` w dokumencie Word może być reprezentowane przez klasę [FieldAuthor](https://reference.aspose.com/words/net/aspose.words.fields/fieldauthor/). Za pomocą klasy **FieldAuthor** możesz wykonać następujące operacje: - podać nazwisko autora dokumentu ``` Aby uzyskać więcej informacji, zobacz klasę [FieldAuthor](https://reference.aspose.com/words/net/aspose.words.fields/fieldauthor/) API. ``` Poniższy przykład kodu pokazuje, jak dodać pole `AUTHOR` za pomocą formatu DOM do akapitu w dokumencie: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertAuthorField-InsertAuthorField.cs" >}} ### Wstawianie pola `INCLUDETEXT` do dokumentu bez użycia narzędzia DocumentBuilder Pole `INCLUDETEXT` wstawia tekst i grafikę zawartą w dokumencie nazwanym w kodzie pola. Można wstawić cały dokument lub jego część, do której odnosi się zakładka. To pole w dokumencie Word jest reprezentowane przez INCLUDETEXT. Klasę [FieldIncludeText](https://reference.aspose.com/words/net/aspose.words.fields/fieldincludetext/) można wykorzystać do wykonania następujących operacji: - podaj nazwę zakładki dołączanego dokumentu - określ lokalizację dokumentu ``` Aby uzyskać więcej informacji, zobacz klasę [FieldIncludeText](https://reference.aspose.com/words/net/aspose.words.fields/fieldincludetext/) API. ``` Poniższy przykład kodu pokazuje, jak dodać pole `INCLUDETEXT` za pomocą formatu DOM do akapitu w dokumencie: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertIncludeFieldWithoutDocumentBuilder-InsertFieldIncludeTextWithoutDocumentBuilder.cs" >}} ### Wstawianie pola `TOA` do dokumentu bez użycia narzędzia DocumentBuilder Pole `TOA` (*Tabela źródeł*) tworzy i wstawia tabelę źródeł. Pole `TOA` gromadzi wpisy oznaczone polami `TA` (*Table of Authorities Entry*). Microsoft Office Word wstawia pole `TOA` po kliknięciu *Wstaw tabelę źródeł* w grupie **Tabela władz** na karcie **References**. Gdy przeglądasz pole `TOA` w swoim dokumencie, składnia wygląda następująco: { `TOA` [Switches ] } ``` Aby uzyskać więcej informacji, zobacz klasę [FieldToa](https://reference.aspose.com/words/net/aspose.words.fields/fieldtoa/) API. ``` Poniższy przykład kodu pokazuje, jak dodać pole `TOA` za pomocą formatu DOM do akapitu w dokumencie: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertTOAFieldWithoutDocumentBuilder-InsertTOAFieldWithoutDocumentBuilder.cs" >}}