FieldPrivate

FieldPrivate class

Implementa il campo PRIVATO.

Per saperne di più, visita ilLavorare con i campi articolo di documentazione.

public class FieldPrivate : Field

Costruttori

Nome	Descrizione
FieldPrivate()	Default_Costruttore

Proprietà

Nome	Descrizione
DisplayResult { get; }	Ottiene il testo che rappresenta il risultato del campo visualizzato.
End { get; }	Ottiene il nodo che rappresenta la fine del campo.
Format { get; }	Ottiene unFieldFormatoggetto che fornisce accesso tipizzato alla formattazione del campo.
IsDirty { get; set; }	Ottiene o imposta se il risultato corrente del campo non è più corretto (obsoleto) a causa di altre modifiche apportate al documento.
IsLocked { get; set; }	Ottiene o imposta se il campo è bloccato (non dovrebbe ricalcolare il suo risultato).
LocaleId { get; set; }	Ottiene o imposta l’LCID del campo.
Result { get; set; }	Ottiene o imposta il testo compreso tra il separatore di campo e la fine del campo.
Separator { get; }	Ottiene il nodo che rappresenta il separatore di campo. Può esserenull .
Start { get; }	Ottiene il nodo che rappresenta l’inizio del campo.
virtual Type { get; }	Ottiene il tipo di campo di Microsoft Word.

Metodi

Nome	Descrizione
GetFieldCode()	Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non c’è un separatore). Sono inclusi sia il codice di campo che il risultato del campo dei campi figlio.
GetFieldCode(bool)	Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non c’è separatore).
Remove()	Rimuove il campo dal documento. Restituisce un nodo subito dopo il campo. Se la fine del campo è l’ultimo nodo figlio del suo nodo padre, restituisce il paragrafo padre. Se il campo è già stato rimosso, restituiscenull .
Unlink()	Esegue lo scollegamento del campo.
Update()	Esegue l’aggiornamento del campo. Genera un’eccezione se il campo è già in fase di aggiornamento.
Update(bool)	Esegue un aggiornamento di campo. Genera un’eccezione se il campo è già in fase di aggiornamento.

Osservazioni

Fornisce un’area di archiviazione privata. Questo campo viene utilizzato per memorizzare i dati dei documenti convertiti da altri formati di file .

Esempi

Mostra come elaborare i campi PRIVATI.

public void FieldPrivate()
{
    // Apriamo un documento Corel WordPerfect che abbiamo convertito in formato .docx.
    Document doc = new Document(MyDir + "Field sample - PRIVATE.docx");

    // I documenti WordPerfect 5.x/6.x come quello che abbiamo caricato potrebbero contenere campi PRIVATI.
    // Microsoft Word conserva i campi PRIVATI durante le operazioni di caricamento/salvataggio,
    // ma non fornisce loro alcuna funzionalità.
    FieldPrivate field = (FieldPrivate)doc.Range.Fields[0];

    Assert.AreEqual(" PRIVATE \"My value\" ", field.GetFieldCode());
    Assert.AreEqual(FieldType.FieldPrivate, field.Type);

    // Possiamo anche inserire campi PRIVATI utilizzando un generatore di documenti.
    DocumentBuilder builder = new DocumentBuilder(doc);
    builder.InsertField(FieldType.FieldPrivate, true);

    // Questi campi non rappresentano un modo efficace per proteggere le informazioni sensibili.
    // A meno che non sia essenziale la compatibilità con le versioni precedenti di WordPerfect,
    // possiamo rimuovere questi campi in sicurezza. Possiamo farlo utilizzando un'implementazione di DocumentVisitor.
    Assert.AreEqual(2, doc.Range.Fields.Count);

    FieldPrivateRemover remover = new FieldPrivateRemover();
    doc.Accept(remover);

    Assert.AreEqual(2, remover.GetFieldsRemovedCount());
    Assert.AreEqual(0, doc.Range.Fields.Count);
}

/// <summary>
/// Rimuove tutti i campi PRIVATE riscontrati.
/// </summary>
public class FieldPrivateRemover : DocumentVisitor
{
    public FieldPrivateRemover()
    {
        mFieldsRemovedCount = 0;
    }

    public int GetFieldsRemovedCount()
    {
        return mFieldsRemovedCount;
    }

    /// <summary>
    /// Chiamato quando nel documento viene rilevato un nodo FieldEnd.
    /// Se il nodo appartiene a un campo PRIVATO, l'intero campo viene rimosso.
    /// </summary>
    public override VisitorAction VisitFieldEnd(FieldEnd fieldEnd)
    {
        if (fieldEnd.FieldType == FieldType.FieldPrivate)
        {
            fieldEnd.GetField().Remove();
            mFieldsRemovedCount++;
        }

        return VisitorAction.Continue;
    }

    private int mFieldsRemovedCount;
}

Guarda anche

• class Field
• spazio dei nomi Aspose.Words.Fields
• assemblea Aspose.Words