Freigeben über


ITextEdit.Insert-Methode (Int32, array<Char[], Int32, Int32)

Fügt ein Array von Zeichen an der angegebenen Position in ITextBufferein.

Namespace:  Microsoft.VisualStudio.Text
Assembly:  Microsoft.VisualStudio.Text.Data (in Microsoft.VisualStudio.Text.Data.dll)

Syntax

'Declaration
Function Insert ( _
    position As Integer, _
    characterBuffer As Char(), _
    startIndex As Integer, _
    length As Integer _
) As Boolean
bool Insert(
    int position,
    char[] characterBuffer,
    int startIndex,
    int length
)
bool Insert(
    int position, 
    array<wchar_t>^ characterBuffer, 
    int startIndex, 
    int length
)
abstract Insert : 
        position:int * 
        characterBuffer:char[] * 
        startIndex:int * 
        length:int -> bool
function Insert(
    position : int, 
    characterBuffer : char[], 
    startIndex : int, 
    length : int
) : boolean

Parameter

  • position
    Typ: Int32

    Die Pufferposition, an der das erste Zeichen des Texts angezeigt werden soll.

  • characterBuffer
    Typ: array<Char[]

    Das Zeichenarray, aus dem Zeichen eingefügt werden.

  • startIndex
    Typ: Int32

    Der Index des ersten einzufügenden Zeichens in characterBuffer.

  • length
    Typ: Int32

    Die Anzahl der aus characterBuffer einzufügenden Zeichen.

Rückgabewert

Typ: Boolean
true , wenn der Einfügevorgang erfolgreich war; false, wenn er von einem schreibgeschützten Bereich verhindert wurde.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

characterBuffer ist nullein Nullverweis (Nothing in Visual Basic).

InvalidOperationException

Apply oder Cancel oder Dispose-Methode ist bereits für dieses Objekt aufgerufen.

ArgumentOutOfRangeException

position ist kleiner als Null oder größer als die Länge des Puffers, oder startIndex ist kleiner als Null oder length ist kleiner als Null oder startIndex + length ist größer als die Länge von characterBuffer.

Hinweise

Das Einfügen von null (folgt, aber keine neue Momentaufnahme generiert und löst ein Changed-Ereignis aus.

.NET Framework-Sicherheit

Siehe auch

Referenz

ITextEdit Schnittstelle

Insert-Überladung

Microsoft.VisualStudio.Text-Namespace