AddProduct_Comfort

Methode (Function) · gibt Integer zurück

AddProduct_Comfort ist eine Methode der Klasse Aloaha_ZUGFeRD.XML im Aloaha ZUGFeRD SDK. Sie betrifft BG-25 (Rechnungsposition), BT-126 (Kennung der Rechnungsposition), BT-127 (Freitext zur Rechnungsposition), BT-155 (Artikelkennung des Verkäufers).

Beschreibung (Originaltext der englischen SDK-Dokumentation): BG-25: Adds an invoice line with prices, item price discount / charge, VAT information and line net amount, using a string line ID.

Rückgabe: Zero-based index of the new line item, or -1 on error

Hinweis: Amounts are normalized; empty currency codes are taken from the other currency parameters or the invoice currency, and an empty invoice currency is set from them. A Basic profile is switched to Comfort. An AllowanceReason or TaxExemptionReason sets the profile to Extended.

Deklaration

Public Function AddProduct_Comfort(ByVal PositionID As String, ByVal Note As String, ByVal SellerAssignedID As String, ByVal BilledQuantity As String, ByVal QuantityUnit As String, ByVal ProductName As String, ByVal ProductDescription As String, ByVal GrossPrice As String, _ ByVal GrossPriceCurrency As String, ByVal BasisQuantity As String, ByVal BasisQuantityUnitCode As String, _ ByVal AllowanceChargeIndicator As Boolean, ByVal AllowanceAmount As String, ByVal AllowanceAmountCurrencyID As String, ByVal AllowanceReason As String, _ ByVal NetPrice As String, ByVal NetPriceCurrencyID As String, ByVal NetPriceBasisQuantity As String, ByVal NetPriceBasisQauntityUnit As String, _ ByVal TaxTypeCode As String, ByVal TAXCategoryCode As String, ByVal TAXPercent As String, ByVal TaxExemptionReason As String, _ ByVal TotalAmount As String, ByVal TotalAmountCurrencyID As String, Optional ByVal GlobalID As String = "", Optional ByVal GlobalIDScheme As String = "") As Integer

Parameter

NameTypPflichtBeschreibung
PositionIDStringerforderlichBT-126: Invoice line identifier (used as given)
NoteStringerforderlichBT-127: Free text note of the line item
SellerAssignedIDStringerforderlichBT-155: Seller assigned item identifier
BilledQuantityStringerforderlichBT-129: Invoiced quantity
QuantityUnitStringerforderlichBT-130: Unit of measure code of the invoiced quantity. Also used as fallback for empty NetPriceBasisQauntityUnit / BasisQuantityUnitCode
ProductNameStringerforderlichBT-153: Item name
ProductDescriptionStringerforderlichBT-154: Item description
GrossPriceStringerforderlichBT-148: Item gross price (unit price ex VAT before price discount)
_Objecterforderlich
BasisQuantityStringerforderlichBase quantity stored with the item price allowance / charge of the gross price
BasisQuantityUnitCodeStringerforderlichUnit code of BasisQuantity
_Objecterforderlich
AllowanceAmountStringerforderlichBT-147: Item price discount / charge amount. Ignored if empty or zero and no AllowanceReason is given
AllowanceAmountCurrencyIDStringerforderlichCurrency code of the allowance / charge amount
AllowanceReasonStringerforderlichReason text of the item price discount / charge
_Objecterforderlich
NetPriceCurrencyIDStringerforderlichCurrency code of the net price
NetPriceBasisQuantityStringerforderlichBT-149: Item price base quantity
NetPriceBasisQauntityUnitStringerforderlichBT-150: Item price base quantity unit code
_Objecterforderlich
TAXCategoryCodeStringerforderlichBT-151: Line VAT category code, for example S, Z, E, AE, K, O
TAXPercentStringerforderlichBT-152: Line VAT rate
TaxExemptionReasonStringerforderlichVAT exemption reason text of the line. If given, the profile is set to Extended
_Objecterforderlich
TotalAmountCurrencyIDStringerforderlichCurrency code of the line net amount
GlobalIDStringoptional (Standard: "")BT-157: Item identifier according to a registered scheme. Only written if GlobalIDScheme is given too
GlobalIDSchemeStringoptional (Standard: "")BT-157-1: Scheme identifier of GlobalID (e.g. 0160 for GTIN)

Aufruf (VB.NET)

Dim alo As New Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, False, "IHR-LIZENZSCHLUESSEL")
Dim PositionID As String = ""
Dim Note As String = ""
Dim SellerAssignedID As String = ""
Dim BilledQuantity As String = ""
Dim QuantityUnit As String = ""
Dim ProductName As String = ""
Dim ProductDescription As String = ""
Dim GrossPrice As String = ""
Dim _ As Object = Nothing
Dim BasisQuantity As String = ""
Dim BasisQuantityUnitCode As String = ""
Dim _ As Object = Nothing
Dim AllowanceAmount As String = ""
Dim AllowanceAmountCurrencyID As String = ""
Dim AllowanceReason As String = ""
Dim _ As Object = Nothing
Dim NetPriceCurrencyID As String = ""
Dim NetPriceBasisQuantity As String = ""
Dim NetPriceBasisQauntityUnit As String = ""
Dim _ As Object = Nothing
Dim TAXCategoryCode As String = ""
Dim TAXPercent As String = ""
Dim TaxExemptionReason As String = ""
Dim _ As Object = Nothing
Dim TotalAmountCurrencyID As String = ""
Dim ergebnis = alo.AddProduct_Comfort(PositionID, Note, SellerAssignedID, BilledQuantity, QuantityUnit, ProductName, ProductDescription, GrossPrice, _, BasisQuantity, BasisQuantityUnitCode, _, AllowanceAmount, AllowanceAmountCurrencyID, AllowanceReason, _, NetPriceCurrencyID, NetPriceBasisQuantity, NetPriceBasisQauntityUnit, _, TAXCategoryCode, TAXPercent, TaxExemptionReason, _, TotalAmountCurrencyID)

Aufruf (C#)

var zfStandard = Aloaha_ZUGFeRD.iXML.ZUGFeRDVersion.xInvoice;   // Optional ByRef im Konstruktor: in C# mit ref übergeben
var alo = new Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, false, "IHR-LIZENZSCHLUESSEL", ref zfStandard);
string positionID = "";
string note = "";
string sellerAssignedID = "";
string billedQuantity = "";
string quantityUnit = "";
string productName = "";
string productDescription = "";
string grossPrice = "";
object _ = default;
string basisQuantity = "";
string basisQuantityUnitCode = "";
object _ = default;
string allowanceAmount = "";
string allowanceAmountCurrencyID = "";
string allowanceReason = "";
object _ = default;
string netPriceCurrencyID = "";
string netPriceBasisQuantity = "";
string netPriceBasisQauntityUnit = "";
object _ = default;
string taxCategoryCode = "";
string taxPercent = "";
string taxExemptionReason = "";
object _ = default;
string totalAmountCurrencyID = "";
var ergebnis = alo.AddProduct_Comfort(positionID, note, sellerAssignedID, billedQuantity, quantityUnit, productName, productDescription, grossPrice, _, basisQuantity, basisQuantityUnitCode, _, allowanceAmount, allowanceAmountCurrencyID, allowanceReason, _, netPriceCurrencyID, netPriceBasisQuantity, netPriceBasisQauntityUnit, _, taxCategoryCode, taxPercent, taxExemptionReason, _, totalAmountCurrencyID);

Vollständiges Beispiel (VB.NET)

' VB.NET (Konsolenanwendung, Verweis auf Aloaha_ZUGFeRD.dll, .NET Framework 4.7.2)
' Komplette E-Rechnung nach EN 16931: 10 x 5,00 EUR netto zu 19 % Umsatzsteuer
Module ZugferdRechnung
    Sub Main()
        ' Kultur wie in den SDK-Beispielen setzen und am Ende zurückstellen; Beträge immer als Text mit Punkt ("50.00")
        Dim kulturSicherung = System.Threading.Thread.CurrentThread.CurrentCulture
        System.Threading.Thread.CurrentThread.CurrentCulture = System.Globalization.CultureInfo.GetCultureInfo("de-DE")
        Try
            Dim alo As New Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, False, "IHR-LIZENZSCHLUESSEL")

            ' 1. Rechnungskopf: BT-1 Nummer, BT-22 Bemerkung, BT-2 Datum (Format 102), BT-5 Währung
            alo.CreateInvoice("RE-2026-0001", "Rechnung gemäß Bestellung", Date.Today.ToString("yyyyMMdd"), "102", "", "", "EUR")
            alo.Document_Type = Aloaha_ZUGFeRD.iXML.DocumentType.Invoice     ' BT-3 = 380 (andere Typen NACH CreateInvoice setzen)

            ' 2. Verkäufer mit USt-IdNr. (BT-31) und Käufer
            alo.WriteSeller("Muster GmbH", "20095", "Hamburg", "Hauptstr. 1", "", "DE", "DE123456789")
            alo.WriteSellerContactPerson("Erika Muster", "Vertrieb", "vertrieb@muster.de", "+49 40 123456")
            alo.set_URIUniversalCommunication("rechnung@muster.de", "EM", True)       ' BT-34
            alo.BuyerName = "Kunde AG"
            alo.BuyerAddressLine1 = "Marktplatz 5"
            alo.BuyerPostCode = "80331"
            alo.BuyerCity = "München"
            alo.BuyerCountry = "DE"
            alo.set_URIUniversalCommunication("einkauf@kunde.de", "EM", False)        ' BT-49

            ' 3. Zahlung: SEPA-Überweisung (BT-81, BT-84, BT-86), Zahlungsbedingung (BT-20)
            alo.AddPaymentMeans(Aloaha_ZUGFeRD.iXML.Payment_Means.SEPA_credit_transfer, "SEPA-Überweisung", _
                                "DE02120300000000202051", "Muster GmbH", "", "BYLADEM1001")
            alo.AddTradePaymentTerms("Zahlbar innerhalb 30 Tagen netto")
            alo.PaymentReference = "RE-2026-0001"

            ' 4. Position (BG-25): 10 Stück (C62) x 5,00 EUR = 50,00 EUR netto, 19 % Kategorie S
            Dim mwstKat As String = alo.VatCategoryCode(Aloaha_ZUGFeRD.iXML.VAT_Category.StandardRate)
            Dim zeile As Integer = alo.AddProduct_Comfort("1", "", "ART-100", "10.00", "C62", "Papier A4", "500 Blatt", _
                                                          "", "EUR", "", "C62", False, "", "", "", _
                                                          "5.00", "EUR", "1.00", "C62", _
                                                          "VAT", mwstKat, "19.00", "", _
                                                          "50.00", "EUR")
            If zeile < 0 Then Throw New Exception("Position nicht angelegt: " & alo.Last_Error)

            ' 5. Umsatzsteuer-Aufschlüsselung (BG-23): Steuer BT-117 = 9,50 auf Basis BT-116 = 50,00
            alo.AddTradeTax("9.50", "EUR", "50.00", "EUR", "VAT", mwstKat, "19.00")

            ' 6. Summen (BG-22): Netto BT-106, Brutto BT-112, Zahlbetrag BT-115, Basis BT-109, Steuer BT-110
            alo.WriteTotals("50.00", "59.50", "59.50", "50.00", "9.50")

            ' 7. XML speichern (voller Pfad mit Backslash, Endung .xml)
            Dim xmlDatei As String = "C:\Rechnungen\RE-2026-0001.xml"
            If alo.SaveXML(xmlDatei) Then
                Console.WriteLine("E-Rechnung gespeichert: " & xmlDatei)
                If alo.LastWarning <> "" Then Console.WriteLine("Hinweis: " & alo.LastWarning)
            Else
                Console.WriteLine("Fehler: " & alo.Last_Error)
            End If
        Catch ex As Exception
            Console.WriteLine("Ausnahme: " & ex.Message)
        Finally
            System.Threading.Thread.CurrentThread.CurrentCulture = kulturSicherung
        End Try
    End Sub
End Module

Vollständiges Beispiel (C#)

// C# (Konsolenanwendung, Verweis auf Aloaha_ZUGFeRD.dll, .NET Framework 4.7.2)
// Komplette E-Rechnung nach EN 16931: 10 x 5,00 EUR netto zu 19 % Umsatzsteuer
using System;
using System.Globalization;
using System.Threading;

class ZugferdRechnung
{
    static void Main()
    {
        // Kultur wie in den SDK-Beispielen setzen und am Ende zurückstellen; Beträge immer als Text mit Punkt ("50.00")
        var kulturSicherung = Thread.CurrentThread.CurrentCulture;
        Thread.CurrentThread.CurrentCulture = CultureInfo.GetCultureInfo("de-DE");
        try
        {
            // Optional ByRef-Parameter (Konstruktor, SaveXML) übergibt C# mit ref
            var standard = Aloaha_ZUGFeRD.iXML.ZUGFeRDVersion.xInvoice;
            var alo = new Aloaha_ZUGFeRD.XML(Aloaha_ZUGFeRD.iXML.ZUGFeRDProfile.comfort, false, "IHR-LIZENZSCHLUESSEL", ref standard);

            // 1. Rechnungskopf: BT-1 Nummer, BT-22 Bemerkung, BT-2 Datum (Format 102), BT-5 Währung
            alo.CreateInvoice("RE-2026-0001", "Rechnung gemäß Bestellung", DateTime.Today.ToString("yyyyMMdd"), "102", "", "", "EUR");
            alo.Document_Type = Aloaha_ZUGFeRD.iXML.DocumentType.Invoice;    // BT-3 = 380 (andere Typen NACH CreateInvoice setzen)

            // 2. Verkäufer mit USt-IdNr. (BT-31) und Käufer
            alo.WriteSeller("Muster GmbH", "20095", "Hamburg", "Hauptstr. 1", "", "DE", "DE123456789");
            alo.WriteSellerContactPerson("Erika Muster", "Vertrieb", "vertrieb@muster.de", "+49 40 123456");
            alo.set_URIUniversalCommunication("rechnung@muster.de", "EM", true);       // BT-34
            alo.BuyerName = "Kunde AG";
            alo.BuyerAddressLine1 = "Marktplatz 5";
            alo.BuyerPostCode = "80331";
            alo.BuyerCity = "München";
            alo.BuyerCountry = "DE";
            alo.set_URIUniversalCommunication("einkauf@kunde.de", "EM", false);        // BT-49

            // 3. Zahlung: SEPA-Überweisung (BT-81, BT-84, BT-86), Zahlungsbedingung (BT-20)
            alo.AddPaymentMeans(Aloaha_ZUGFeRD.iXML.Payment_Means.SEPA_credit_transfer, "SEPA-Überweisung",
                                "DE02120300000000202051", "Muster GmbH", "", "BYLADEM1001");
            alo.AddTradePaymentTerms("Zahlbar innerhalb 30 Tagen netto");
            alo.PaymentReference = "RE-2026-0001";

            // 4. Position (BG-25): 10 Stück (C62) x 5,00 EUR = 50,00 EUR netto, 19 % Kategorie S
            //    VatCategoryCode ist in VB eine Eigenschaft mit Parameter -> in C# get_VatCategoryCode(...)
            string mwstKat = alo.get_VatCategoryCode(Aloaha_ZUGFeRD.iXML.VAT_Category.StandardRate);
            int zeile = alo.AddProduct_Comfort("1", "", "ART-100", "10.00", "C62", "Papier A4", "500 Blatt",
                                               "", "EUR", "", "C62", false, "", "", "",
                                               "5.00", "EUR", "1.00", "C62",
                                               "VAT", mwstKat, "19.00", "",
                                               "50.00", "EUR");
            if (zeile < 0) throw new Exception("Position nicht angelegt: " + alo.Last_Error);

            // 5. Umsatzsteuer-Aufschlüsselung (BG-23): Steuer BT-117 = 9,50 auf Basis BT-116 = 50,00
            alo.AddTradeTax("9.50", "EUR", "50.00", "EUR", "VAT", mwstKat, "19.00");

            // 6. Summen (BG-22): Netto BT-106, Brutto BT-112, Zahlbetrag BT-115, Basis BT-109, Steuer BT-110
            alo.WriteTotals("50.00", "59.50", "59.50", "50.00", "9.50");

            // 7. XML speichern; der 3. Parameter ist Optional ByRef -> in C# mit ref übergeben
            string xmlDatei = @"C:\Rechnungen\RE-2026-0001.xml";
            if (alo.SaveXML(xmlDatei, "", ref standard))
            {
                Console.WriteLine("E-Rechnung gespeichert: " + xmlDatei);
                if (alo.LastWarning != "") Console.WriteLine("Hinweis: " + alo.LastWarning);
            }
            else
            {
                Console.WriteLine("Fehler: " + alo.Last_Error);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine("Ausnahme: " + ex.Message);
        }
        finally
        {
            Thread.CurrentThread.CurrentCulture = kulturSicherung;
        }
    }
}

Worauf es bei AddProduct_Comfort ankommt:

  • Rückgabe ist der nullbasierte Index der neuen Position (−1 bei Fehler, Grund in Last_Error). Mit diesem Index ergänzen Sie die Position später, z. B. über Trade_ItemTradeAgreement(index).
  • Nettobetrag der Position (BT-131) = Menge × Nettopreis, gerundet auf 2 Stellen. Die Summen (BT-106) bilden Sie aus den gerundeten Positionsbeträgen, sonst melden Validatoren BR-CO-10.
  • Mengeneinheiten (BT-130) nach UN/ECE Rec. 20, z. B. C62 Stück, HUR Stunde, KGM Kilogramm.
  • Lassen Sie TaxExemptionReason in der Position leer: ein Befreiungsgrund auf Positionsebene stellt die Rechnung auf Factur-X EXTENDED um (dann keine XRechnung). Der Grund, etwa bei §13b, gehört in AddTradeTax.
  • Es gibt zwei Überladungen (PositionID als Integer oder String). Über COM heißen sie AddProduct_Comfort (Integer) und AddProduct_Comfort_2 (String).

Das Beispiel ist dieselbe Rechnung wie im Schnellstart VB.NET – hier als vollständiges Programm mit Fehlerbehandlung, in VB.NET und C#. Prüfen Sie die erzeugte XML mit dem KoSIT-Validator (XRechnung) oder Mustang (EN 16931 / EXTENDED); eine hybride PDF/A-3-Rechnung entsteht anschließend mit MergeXMLIntoPDF.

Business Terms (EN 16931)

Artikel mit AddProduct_Comfort

Der Rechnung Posten mit AddProduct_Comfort hinzufügen

“AddProduct_Comfort” ist wahrscheinlich der am häufigsten verwendete API-Aufruf des Aloaha ZUGFeRD-Toolkits. Der vollständige Aufruf lautet: Dim ItemID as integer=-1 ItemID =…

3. Mai 2024BG-25 BT-126 BT-127 BT-129 BT-130 BT-131

Erstellung einer ZUGFeRD/X-Rechnung XML Datei via COM Schnittstelle (VB6 / VBA) with Late Binding

Um den Einstieg in die Nutzung unseres SDK zu erleichtern, haben wir ein neues Beispiel entwickelt, das demonstriert, wie eine vollständige ZUGFeRD XML-Datei erstellt wird. Für die Erstellung dieses…

29. April 2024BT-1 BT-122 BT-123 BT-13 BT-17 BT-18

Erstellung einer ZUGFeRD/X-Rechnung XML Datei via COM Schnittstelle (VB6 / VBA) oder .NET (Early Binding)

Um den Einstieg in die Nutzung unseres SDK zu erleichtern, haben wir ein neues Beispiel entwickelt, das demonstriert, wie eine vollständige ZUGFeRD XML-Datei erstellt wird. Für die Erstellung dieses…

30. April 2024BT-1 BT-122 BT-123 BT-13 BT-17 BT-18

Erstellung einer ZUGFeRD/XRechnung XML Datei

Um Anfangsschwierigkeiten bei der Benutzung unseres SDK zu verringern haben wir ein neues Beispiel erstellt um eine komplette ZUGFeRD XML Datei zu erstellen. NEU: Beispiel für VB6 / VBA / .NET:…

23. Juli 2023BT-23 BT-34 BT-41 BT-42 BT-43 BT-49

Innergemeinschaftlichen Rechnung und ShipToTradeParty, BT-80

Bei einer innergemeinschaftlichen Rechnung und dem CategoryCode K bei der Umsatzsteuer erhält man häufig von Validatoren die folgenden Fehler: [BR-IC-12]-In an Invoice with a VAT breakdown (BG-23)…

4. März 2022BT-80 BG-23 BT-118

F: Was bedeuten „zero rated goods“ und „commercial invoice“ bei einer §13b-Abschlagsrechnung?

Kurz: Wenn ein Rechnungsempfänger meldet, Ihre E-Rechnung enthalte „zero rated goods“ statt „VAT reverse charge“ und sei eine „commercial invoice“ statt einer „partial construction invoice“, dann zitiert er die …

14. Oktober 2026BT-3 BT-118 BT-151 BT-121 BT-120 BT-31

F: Wie setze ich den Befreiungsgrund (ExemptionReasonCode) in den Positionen – und warum warnt der Validator?

Kurz: In EN 16931 und XRechnung gibt es keinen Befreiungsgrund in der Position. Text ( BT-120 ) und Code ( BT-121 , z. B. VATEX-EU-IC ) gehören nur in die Steueraufschlüsselung: Parameter 8 und 12 von AddTradeTax . Die …

12. November 2026BT-120 BT-121 BT-151 BT-118 BT-24 BT-131

F: Wie übergebe ich die Positionsnummer aus der Bestellung des Kunden (BT-132) in der Rechnungsposition?

Kurz: Viele Kunden, vor allem mit SAP, verlangen auf der E-Rechnung zu jeder Position die Positionsnummer aus ihrer Bestellung. Das ist der Business Term BT-132 („Referenced purchase order line reference“, auch …

20. Oktober 2026BT-132 BT-13 BG-25 BT-126 BT-127

F: Validator meldet BR-FXEXT-IC-08 bei einer innergemeinschaftlichen Lieferung – was tun?

Kurz: Die Regel BR-FXEXT-IC-08 gibt es nur im Profil Factur-X/ZUGFeRD EXTENDED . Sie meldet sich typischerweise bei einer steuerfreien innergemeinschaftlichen Lieferung (Kategorie K) mit einem Zuschlag auf Belegebene, …

11. November 2026BT-116 BT-120 BT-24 BT-99 BT-131 BT-48

F: Warum meldet der Validator BR-S-08, BR-S-09 und BR-CO-17, wenn die Rechnung einen Rabatt hat?

Kurz: Die drei Regeln BR-S-08 , BR-S-09 und BR-CO-17 melden zusammen fast immer denselben Fehler: In der Umsatzsteuer-Aufschlüsselung (BG-23) steht als Basisbetrag ( BT-116 ) die Summe der Positionen statt des …

15. Oktober 2026BT-116 BT-117 BT-92 BT-106 BT-107 BT-109

F: Wie stelle ich Frachtkosten in der E-Rechnung dar – frei Bau oder ab Werk?

Kurz: Frachtkosten („ab Werk“, Lieferung wird extra berechnet) lassen sich in einer E-Rechnung auf drei Wegen abbilden, die alle in EN 16931 und XRechnung erlaubt sind – ein Wechsel ins Profil EXTENDED ist dafür nicht …

24. Oktober 2026BG-21 BG-28 BT-99 BT-141 BT-104 BT-105

F: Warum warnt der Validator vor einem leeren ApplicableHeaderTradeDelivery (PEPPOL-EN16931-R008)?

Kurz: Die Warnung PEPPOL-EN16931-R008 („Document MUST not contain empty elements“) beim Element ApplicableHeaderTradeDelivery bedeutet: Der Lieferblock ist vorhanden, aber leer. Der Block ist im Schema Pflicht und muss …

14. Oktober 2026BG-13 BT-72 BT-70 BT-75 BT-77 BT-78

COM-Schnittstelle

AddProduct_Comfort ist Mitglied der Schnittstelle Aloaha_ZUGFeRD.iXML (Position 80 von 343) und damit auch aus VB6, VBA/Access und anderen COM-Clients über CreateObject("Aloaha_ZUGFeRD.XML") aufrufbar. Neue Mitglieder werden immer am Ende von iXML angefügt, damit bestehende COM-Clients unverändert weiterlaufen; nach einem Update die Typbibliothek neu registrieren.

Quelle: XML-Dokumentationskommentare des Aloaha ZUGFeRD SDK (xml.vb). Gleiche Signatur in VB6/VBA über COM. In C# werden ByRef-Parameter mit ref übergeben, VB-Eigenschaften mit Parametern heißen get_…/set_…, optionale Parameter können entfallen.