DbAppend(): Unterschied zwischen den Versionen

Aus Wiki des Deutschsprachige Xbaseentwickler e. V.
Zur Navigation springen Zur Suche springen
 
(7 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 3: Zeile 3:
Die DbAppend() Funktion ermöglicht es einen neuen, leeren Datensatz an das Ende einer DBF-Datei zu hängen.
Die DbAppend() Funktion ermöglicht es einen neuen, leeren Datensatz an das Ende einer DBF-Datei zu hängen.


Als Gegenstück kann auch APPEND BLANK verwendet werden.


== Syntax ==
== Syntax ==


DbAppend( [<nLockMode>] ) --> NIL
DbAppend( [<nLockMode>] ) --> NIL


== Parameter ==
== Parameter ==
 
<nLockMode> Wenn für <nLockMode> der Wert 1 gesetzt wird, bleiben Satzsperren bestehen, die beim Aufruf von DbAppend() gesetzt waren. Im anderen Fall werden alle, zu dem Zeitpunkt vorhandenen Satzsperren, aufgehoben.


== Querverweise ==
== Querverweise ==
Zeile 21: Zeile 22:
== Anwendungsbeispiel ==
== Anwendungsbeispiel ==


PROCEDURE Main  
  [[PROCEDURE]] [[Main]]
          LOCAL cArticle := Space(50)  
            [[LOCAL]] cArticle := [[Space()|Space]](50)  
          LOCAL cArtNo  := Space(10)
            LOCAL cArtNo  := Space(10)
          DbUseArea(.T.,,"artikel","art")
          art->(DbSetIndex("ArtikelA"))
          art->(DbSetIndex("ArtikelB"))
   
   
          CLS  
            CLS
          @ 10,5 SAY "Artikel Nummer    :" GET cArtNo
            [[DbUseArea()|DbUseArea]](.T.,,"artikel","art")
          @ 11,5 SAY "Artikel Bezeichnung:" GET cArticle
          READ
   
   
          IF ! Empty( cArtNo + cArticle )  
            art->[[DbSetIndex()|(DbSetIndex]]("ArtikelA"))
            art->(DbAppend())
            art->(DbSetIndex("ArtikelB"))
            IF NetErr()  
       
                ? "Datensatz konnte nicht erzeugt werden"  
            @ 12,5 [[SAY]] "Nummer    :" [[GET]] cArtNo  [[PICTURE]] "99999999"
            ELSE  
            @ 13,5 SAY "Bezeichnung:" GET cArticle PICTURE "@K !" + Repl("X",19)
                art->ArtNo  := cArtNo
            [[READ]]
                art->Artikel := cArticle  
            [[IF]] [[!]] [[Empty()|Empty]]( cArtNo + cArticle )  
            ENDIF  
              art->(DbAppend())
          ENDIF  
              IF [[NetErr()]]
          art->(DbCloseArea())
                  ? "Datensatz konnte nicht erzeugt werden"  
          RETURN
              ELSE  
                  art->ArtNo  := cArtNo
                  art->Artikel := cArticle  
              ENDIF  
            ENDIF
            art->([[DbCloseArea()]])
            [[RETURN]]

Aktuelle Version vom 15. Juni 2013, 10:47 Uhr

Allgemeines

Die DbAppend() Funktion ermöglicht es einen neuen, leeren Datensatz an das Ende einer DBF-Datei zu hängen.

Als Gegenstück kann auch APPEND BLANK verwendet werden.

Syntax

DbAppend( [<nLockMode>] ) --> NIL

Parameter

<nLockMode> Wenn für <nLockMode> der Wert 1 gesetzt wird, bleiben Satzsperren bestehen, die beim Aufruf von DbAppend() gesetzt waren. Im anderen Fall werden alle, zu dem Zeitpunkt vorhandenen Satzsperren, aufgehoben.

Querverweise

benötigte DLLs bzw. Include-Dateien

Anwendungsbeispiel

 PROCEDURE Main 
           LOCAL cArticle := Space(50) 
           LOCAL cArtNo   := Space(10)

           CLS
           DbUseArea(.T.,,"artikel","art")

           art->(DbSetIndex("ArtikelA"))
           art->(DbSetIndex("ArtikelB"))
       
           @ 12,5 SAY "Nummer     :" GET cArtNo   PICTURE "99999999"
           @ 13,5 SAY "Bezeichnung:" GET cArticle PICTURE "@K !" + Repl("X",19)
           READ 
           IF ! Empty( cArtNo + cArticle ) 
              art->(DbAppend())
              IF NetErr() 
                 ? "Datensatz konnte nicht erzeugt werden" 
              ELSE 
                 art->ArtNo   := cArtNo
                 art->Artikel := cArticle 
              ENDIF 
           ENDIF
           art->(DbCloseArea())
           RETURN