TextHelper Komponente für Windows- 95/98, NT, ME und 2000

ISSB TextHelper hilft, VB- oder JavaScript-Code in ASP-Seiten und VB-Programmen klein zu halten, wenn es um Textoperationen geht, wie z. B. Umkehrung von Zeichenfolgen, Durchzählen von bestimmten Zeichenfolgen oder das Herauslösen des Bodytextes aus einer HTML-Seite usw.
Base64-Entschlüsselung sowie Verschlüsselung von Texten kein Problem.

Die Komponente übernimmt durch einzelne Methoden die Aufgabe von Textoperationen, die sich ansonsten im VB-Code über mehrere Zeilen erstrecken können. 

Methoden

• CropText (Text, Len)
  Kürzt den übergebenen Text auf die im Parameter Len angegebene Anzahl von Zeichen, setzt ggf. Verkürzungspunkte "..." an das Ende der gekürzten Zeichenkette und gibt diese zurück.
   
• DateEnglishToGerman (EnglishDateFormat)
  Wandelt das übergebene Datumsformat m/d/y in dd.mm.yyyy und gibt die gewandelte Zeichenkette zurück.
   
• DecryptString (EncryptText, Password)
  Entschlüsselt den mit EncryptString verschlüsselten in EncryptText übergebenen Text und gibt den entschlüsselten Text zurück. Erfordert die Angabe des gültigen Passwortes, welches zum Verschlüsseln mit EncryptString benutzt wurde.
   
• EncryptString (SourceText, Password)
  Verschlüsselt den in SourceText angegebenen Text mit einem Algorithmus und gibt den verschlüsselten Text im hexadezimalen Textformat zurück. Es werden immer nur Zeichen von 0-9 und von A-F zurückgeliefert, so dass die zusammengesetzte Zeichenfolge im reinen Textformat abgespeichert werden kann. Für die Verschlüsselung ist ein Passwort erforderlich.
   
• FromBase64 (Base64Encoded, ToString)
  Decodiert einen base64-codierten String und gibt bei ToString: True eine entschlüsselte Zeichenfolge, bei ToString: False einen Binärstream zurück.
  ToString sollte nur auf True gesetzt werden, wenn ein Text erwartet wird, d. h. wenn eine base64-verschlüsselte Zeichenfolge in Base64Encoded übergeben wird.
   
• GetCryptKey (Password)
  Generiert ein verschlüsseltes (unmerkbares) Passwort und gibt dieses zurück. Die Angabe eines Passwortes ist erforderlich.
   
• GetHtmlBody (CompleteHTML)
  gibt den HTML-Text zurück, der zwischen der HTML-Marke <body...> und </body> steht.
  Wenn die Body-Marke nicht im übergebeben Text vorkommt, wird der gesamte Text zurückgegeben.
   
• GetNewGUID
  Generiert eine weltweit eindeutige 36-stellige GUID und gibt diese zurück.
  Format: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.
   
• GetTextBetween (Text, BeginMark, EndMark, StartPos)
  Gibt den Text zurück, der sich zwischen BeginMark und EndMark des in Text übergebenen Textes befindet.
  BeginMark und EndMark können beliebige Zeichenfolgen sein. Wird eine leere Zeichenfolge in BeginMark übergeben, sucht GetTextBetween ab Text-Anfang. Wird eine leere Zeichenfolge in EndMark übergeben, sucht GetTextBetween ab BeginMark bis Text-Ende.
  StartPos ist 0-basierend. Das erste Zeichen des Textes ist StartPos 0.
  GetTextBetween setzt nach der Suche die Eigenschaft TextPosition auf die Position hinter das letzte Zeichen von EndMark. Wenn EndMark eine leere Zeichenfolge ist, wird TextPosition auf das Textende gesetzt.
   
• HtmlToText (HtmlText, MaxLen)
  Entfernt HTML-Marken, wandelt <br> und <p> in zusätzliche Zeilenvorschübe "\r\n" und kürzt den zurückgegebenen Text auf die in MaxLen angegebene Anzahl von Zeichen.
  Ist MaxLen -1, wird der gesamte übergebene Text gewandelt und zurückgegeben.
   
• RemoveHtmlTags (HtmlText, HtmlTags)
  Entfernt die in HtmlTags angegebenen HTML-Marken vollständig und gibt die resultierende Zeichenfolge zurück. Mehrere HTML-Tags werden mit Komma getrennt angegeben. Es braucht nur die Anfangsmarke z. B. b angegeben werden. Die Endmarke /b wird automatisch mit entfernt.
   
• ReplaceBetween (Text, BeginMark, EndMark, ReplaceWith)
  Ersetzt die Zeichenfolgen, die sich im Text zwischen den Marken BeginMark und EndMark befinden. Es können beliebige Begrenzungsmarken festgelegt werden.
   
• ReplaceHtmlTags (HtmlText)
  Ersetzt alle HTML-Markenzeichen (<>) durch im Internet-Browser darstellbare Zeichen, damit sämtliche HTML-Tags bei der Darstellung wirkungslos sind und als Text angezeigt werden.
   
• Reverse (Text)
  Gibt die Umkehrung der übergebenen Zeichenfolge zurück.
   
• SearchAndMark (Text, SubStr)
  Sucht die übergebene Zeichenfolge (SubStr) im übergebenen Text und markiert die gefundenen Stellen mit HTML-Marken sowie mit Hyperlinks (siehe Eigenschaft HTMLTagForFoundStrings und MakeFoundAnchors). Es wird HTML-Text zurückgegeben, wenn es Fundstellen gibt. Die Anzahl gefundener Vorkommen wird am Anfang und am Ende des durchsuchten Textes ausgegeben.
   
• SearchInnerHtmlText (HtmlText, SubStr)
  Sucht die übergebene Zeichenfolge (SubStr) im übergebenen HTML-Text und markiert die gefundenen Stellen mit HTML-Marken sowie mit Hyperlinks (siehe Eigenschaft HTMLTagForFoundStrings und MakeFoundAnchors). HTML-Tags werden von der Suche ausgeschlossen. Es wird nur in darstellbarem Text gesucht. Die Anzahl gefundener Vorkommen wird am Anfang und am Ende des durchsuchten Textes ausgegeben.
   
• SubStrCount (Text, SubStr)
  zählt die Vorkommen einer übergebenen Zeichenfolge (SubStr) im Text und gibt die Anzahl zurück.

 
• TextToHtmlBreaks (Text, MaxCount)
  Ersetzt die in Text enthaltenen Zeilenvorschübe durch die HTML-Marke <br> und gibt den ersetzten Text zurück. Kürzt ggf. die Zeichenkette. Bei MaxCount -1 wird der ungekürzte Text zurückgegeben.

 
• Trim (Text, Targets, TrimFlags)
  Schneidet Leerzeichen, Tabulator-Zeichen und Zeilenvorschübe links und rechts des übergebenen Textes in Abhängigkeit von TrimFlags ab und gibt die Zeichenfolge zurück.
  TrimFlags = 0 (kein Bit): Zeilenvorschübe, Tabulatoren und Leerzeichen werden links und rechts abgeschnitten.
  TrimFlags = 1 (Bit 1): die in Targets angegebenen Zeichen werden im übergebenen Text links abgeschnitten.
  TrimFlags = 2 (Bit 2): die in Targets angegebenen Zeichen werden im übergebenen Text rechts abgeschnitten.
  TrimFlags = 3 (Bit 1 und 2): die in Targets angegebenen Zeichen werden im übergebenen Text links und rechts abgeschnitten.

 
• WordWrap (Text, LineMaxChars, LineEndChars)
  Bricht Wörter im angegebenen Text um, dass eine Zeile max. die in LineMaxChars angegebene Anzahl an Zeichen lang ist und gibt den entstandenen Blocktext zurück.
  Wird in LineEndChars eine leere Zeichenfolge übergeben, werden an das jedes Zeilenende Zeilenvorschübe angehangen. Andernfalls werden die in LineEndChars übergebenen Zeichenfolgen an jedes Zeilenende angehangen.

Eigenschaften

• CaseSensitive (bool)
  gibt an, ob in den Suchfunktionen dieser Komponente Groß- und Kleinschreibung beachtet wird.
   
• HTMLTagForFoundStrings (string)
  Gibt den HTML-tag (z. B. b für bold) für Markierung gefundener Substrings an.
  Diese Eigenschaft wird von der Methode SearchAndMark genutzt.
  Eine markierte Zeichenfolge wird mit der Eigenschaft HTMLTagForFoundStrings="b" folgendermaßen dargestellt werden: <b>Substring</b>.
  Es ist auch möglich, eine CSS-Klasse zu übergeben, z. B. HTMLTagForFoundStrings="font class='highlight' ".
   
• MakeFoundAnchors (bool)
  Gibt an, ob bei der Methode SearchAndMark Hyperlinks zur vorhergehenden und nächsten Fundstelle markierter Zeichenfolgen eingefügt werden.

 
• TextPosition (long)
  Gibt die Textposition (0-basierend) zurück, die für die nächste Startposition in GetTextBetween als neue Startposition verwendet werden kann. Bei Aufruf von GetTextBetween wird TextPosition erneut gesetzt.

Objekterstellung in ASP-Seiten

Set obj = Server.CreateObject("ISSB.TextHelper")

Nutzung der Methoden in ASP-Seiten

strText = " längerer ... Text "

if strText > "" then Response.Write oTextHelper.CropText(strText, 6)

if strText > "" then Response.Write oTextHelper.SearchAndMark(strText, "test")

Zerstörung des Objektes

Set obj = Nothing

TextHelperCom in Aktion

[Test der Komponente TextHelper in einer ASP-Seite]

Beispiel

Set oTextHelper = Server.CreateObject("ISSB.TextHelper")
oTextHelper.CaseSensitive = True ' False
oTextHelper.HTMLTagForFoundStrings = "font class=""highlight"""
Response.Write oTextHelper.SearchAndMark(strText, strSearchStr)
Set oTextHelper = Nothing

Installation

• Komponente laden... (Bitte nur laden und installieren, wenn Sie die Nutzungsbedingungen gelesen haben.)
• Komponente auspacken und die Datei TextHelperCom.dll in ein beliebiges lokales Verzeichnis kopieren...
• regsvr32 [komponenten-dir]\TextHelperCom.dll ausführen...
  komponenten-dir ist das Verzeichnis, in der sich die DLL befindet.

Deinstallation

Um die Komponente zu deinstallieren, muss der Webserver (MS IIS) beendet werden. Den Webserver kann man im Dienste-Manager beenden. Ein "Anhalten"-Klick im Webserver-Manager (MS MMC) reicht nicht.

Die Komponente wird mit regsvr32 [komponenten-dir]\TextHelperCom.dll /u aus dem System entfernt.

Sie kann dann einfach aus dem Verzeichnis gelöscht werden.

[TextHelper Komponente herunterladen] 

© 2001 ISSB. Alle Rechte vorbehalten.