DoCmd. SendObject-Methode (Access)DoCmd.SendObject method (Access)

Mit der SendObject-Methode wird die SendObject-Aktion in Visual Basic ausgeführt.The SendObject method carries out the SendObject action in Visual Basic.

SyntaxSyntax

Ausdruck. SendObject (__ ObjectType __, ObjectName, OutputFormat, to, CC, Bcc, Subject, MessageText, EditMessage, Templatedatei)expression.SendObject (ObjectType, ObjectName, OutputFormat, To, Cc, Bcc, Subject, MessageText, EditMessage, TemplateFile)

Ausdruck Eine Variable, die ein DoCmd -Objekt darstellt.expression A variable that represents a DoCmd object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
ObjectTypeObjectType OptionalOptional AcSendObjectTypeAcSendObjectType Eine AcSendObjectType -Konstante, die den Typ des zu sendenden Objekts angibt.An AcSendObjectType constant that specifies the type of object to send.
ObjectNameObjectName OptionalOptional VariantVariant Ein Zeichenfolgenausdruck, der dem gültigen Namen eines Objekts des Typs entspricht, der vom Argument ObjectType ausgewählt wurde.A string expression that's the valid name of an object of the type selected by the ObjectType argument. Wenn Sie das aktive Objekt in eine E-Mail-Nachricht einschließen möchten, müssen Sie den Typ des Objekts mithilfe des Arguments ObjectType angeben; für dieses Argument geben Sie dann keinen Wert an.If you want to include the active object in the mail message, specify the object's type with the ObjectType argument and leave this argument blank. Wenn Sie für das Argument ObjectType als auch für das Argument ObjectName keinen Wert angeben, wird von Microsoft Access eine Nachricht an die E-Mail-Anwendung gesendet, ohne ein Datenbankobjekt in die Nachricht einzuschließen (in diesem Fall wird für das Argument ObjectType die acSendNoObject -Standardkonstante verwendet).If you leave both the ObjectType and ObjectName arguments blank (the default constant, acSendNoObject, is assumed for the ObjectType argument), Microsoft Access sends a message to the electronic mail application without an included database object.

Wenn Sie Visual Basic-Code ausführen, **** der die SendObject-Methode in einer Bibliotheksdatenbank enthält, sucht Access zuerst in der Bibliotheksdatenbank und dann in der aktuellen Datenbank nach dem Objekt mit diesem Namen.If you run Visual Basic code containing the SendObject method in a library database, Access looks for the object with this name first in the library database, and then in the current database.
OutputFormatOutputFormat OptionalOptional VariantVariant Eine Konstante, die das Format angibt, in dem das Objekt gesendet werden soll.A constant that specifies the format in which to send the object. Mögliche Werte sind acFormatHTML, acFormatRTF, acFormatSNP, acFormatTXT, acFormatXLS, acFormatXLSB, acFormatXLSX, acFormatXPS und acFormatPDF.Possible values include acFormatHTML, acFormatRTF, acFormatSNP, acFormatTXT, acFormatXLS, acFormatXLSB, acFormatXLSX, acFormatXPS, and acFormatPDF.
ToTo OptionalOptional VariantVariant A string expression that lists the recipients whose names you want to put on the To line in the mail message.A string expression that lists the recipients whose names you want to put on the To line in the mail message. Trennen Sie die Empfängernamen, die Sie in diesem Argument angeben, und in den Argumenten CC und Bcc mit einem Semikolon (;) oder mit dem Listentrennzeichen, das auf der Registerkarte Nummer des Dialogfelds Eigenschaften von Regionseinstellungen im Fenster Systemsteuerung.Separate the recipient names that you specify in this argument and in the Cc and Bcc arguments with a semicolon (;), or with the list separator set on the Number tab of the Regional Settings Properties dialog box in the Windows Control Panel. If the recipient names aren't recognized by the mail application, the message isn't sent and an error occurs.If the recipient names aren't recognized by the mail application, the message isn't sent and an error occurs. If you leave this argument blank, Microsoft Access prompts you for the recipients.If you leave this argument blank, Microsoft Access prompts you for the recipients.
CcCc OptionalOptional VariantVariant Ein Zeichenfolgenausdruck, der die Empfänger auflistet, deren Namen in die Cc-Zeile der E-Mail-Nachricht aufgenommen werden sollen.A string expression that lists the recipients whose names you want to put on the Cc line in the mail message. Wenn Sie für dieses Argument keinen Wert angeben, ist die Cc-Zeile der E-Mail-Nachricht leer.If you leave this argument blank, the Cc line in the mail message is blank.
BccBcc OptionalOptional VariantVariant Ein Zeichenfolgenausdruck, der die Empfänger auflistet, deren Namen in die Bcc-Zeile der E-Mail-Nachricht aufgenommen werden sollen.A string expression that lists the recipients whose names you want to put on the Bcc line in the mail message. Wenn Sie für dieses Argument keinen Wert angeben, ist die Bcc-Zeile der E-Mail-Nachricht leer.If you leave this argument blank, the Bcc line in the mail message is blank.
SubjectSubject OptionalOptional VariantVariant Ein Zeichenfolgenausdruck mit dem Text, der in der Betreffzeile **** der e-Mail-Nachricht eingefügt werden soll.A string expression containing the text that you want to put on the Subject line in the mail message. Wenn Sie für dieses Argument keinen Wert angeben, ist die Zeile Betreff der E-Mail-Nachricht leer.If you leave this argument blank, the Subject line in the mail message is blank.
MessageTextMessageText OptionalOptional VariantVariant Ein Zeichenfolgenausdruck, der den Text enthält, den Sie im Textkörper der e-Mail-Nachricht nach dem Objekt einschließen möchten.A string expression containing the text that you want to include in the body of the mail message, after the object. Wenn Sie für dieses Argument keinen Wert angeben, wird nur das Objekt, jedoch kein Text in die E-Mail-Nachricht eingeschlossen.If you leave this argument blank, the object is all that's included in the body of the mail message.
EditMessageEditMessage OptionalOptional VariantVariant Verwenden Sie true (1), um die e-Mail-Anwendung sofort mit der geladenen Nachricht zu öffnen, damit die Nachricht bearbeitet werden kann.Use True (1) to open the electronic mail application immediately with the message loaded, so the message can be edited. Verwenden Sie False (0), um die Nachricht ohne vorherige Bearbeitung zu senden.Use False (0) to send the message without editing it. Wenn Sie für dieses Argument keinen Wert angeben, wird der Standardwert (True) verwendet.If you leave this argument blank, the default (True) is assumed.
TemplateFileTemplateFile OptionalOptional VariantVariant Ein Zeichenfolgenausdruck, der der vollständige Name, einschließlich des Pfads der Datei ist, die Sie als Vorlage für eine HTML-Datei verwenden möchten.A string expression that's the full name, including the path, of the file that you want to use as a template for an HTML file.

BemerkungenRemarks

Sie können die SendObject-Aktion verwenden, um das angegebene Datenblatt, das angegebene Formular, den angegebenen Bericht oder das angegebene Modul in eine E-Mail-Nachricht einzuschließen, wo sie angezeigt und weitergeleitet werden kann. You can use the SendObject action to include the specified Microsoft Access datasheet, form, report, or module in an electronic mail message, where it can be viewed and forwarded. You can include objects in Microsoft Excel 2000 (*.xls), MS-DOS text (*.txt), rich-text (*.rtf), or HTML (*.html) format in messages for Microsoft Outlook, Microsoft Exchange, or another electronic mail application that uses the Mail Applications Programming Interface (MAPI).You can include objects in Microsoft Excel 2000 (*.xls), MS-DOS text (*.txt), rich-text (*.rtf), or HTML (*.html) format in messages for Microsoft Outlook, Microsoft Exchange, or another electronic mail application that uses the Mail Applications Programming Interface (MAPI).

Die folgenden Regeln gelten, wenn Sie die SendObject-Aktion verwenden, um ein Datenbankobjekt in eine e-Mail-Nachricht einzuschließen:The following rules apply when you use the SendObject action to include a database object in a mail message:

  • Sie können Tabellen-, Abfrage- und Formulardatenblätter senden.You can send table, query, and form datasheets. Im verwendeten Objekt sehen alle Felder im Datenblatt so aus wie in Access, mit Ausnahme der Felder, die OLE-Objekte enthalten.In the included object, all fields in the datasheet look as they do in Access, except fields containing OLE objects. Die Spalten für diese Felder sind im Objekt eingeschlossen, die Felder sind jedoch leer.The columns for these fields are included in the object, but the fields are blank.

  • Bei einem Steuerelement, das an ein Ja/Nein -Feld (eine Umschaltfläche, eine Optionsschaltfläche oder ein Kontrollkästchen) gebunden ist, wird in der Ausgabedatei der Wert 1 (ja) oder 0 (Nein) angezeigt.For a control bound to a Yes/No field (a toggle button, option button, or check box), the output file displays the value 1 (Yes) or 0 (No).

  • Für ein Textfeld, das an das Feld Hyperlink gebunden ist, wird in der Ausgabedatei der Hyperlink für alle Ausgabeformate mit Ausnahme von MS-DOS-Text angezeigt (in diesem Fall wird der Hyperlink nur als normaler Text angezeigt).For a text box bound to a Hyperlink field, the output file displays the hyperlink for all output formats except MS-DOS text (in this case, the hyperlink is just displayed as normal text).

  • Wenn Sie ein Formular in der Formularansicht senden, enthält das eingeschlossene Objekt immer die Datenblattansicht des Objekts.If you send a form in Form view, the included object always contains the form's Datasheet view.

  • Wenn Sie einen Bericht senden, sind die einzigen Steuerelemente, die im Objekt eingeschlossen sind, Textfelder (für XLS-Dateien) oder Textfelder und Beschriftungen (für RTF-, TXT- und HTML-Dateien).If you send a report, the only controls that are included in the object are text boxes (for .xls files), or text boxes and labels (for .rtf, .txt, and .html files). Alle anderen Steuerelemente werden ignoriert.All other controls are ignored. Auch Kopf- und Fußzeileninformationen werden ausgeschlossen.Header and footer information is also not included. Die einzige Ausnahme besteht darin, dass beim Senden eines Berichts im Excel-Format ein Textfeld in einem Gruppenfuß, das einen Ausdruck mit der Summe -Funktion enthält, in das Objekt eingeschlossen wird.The only exception to this is that when you send a report in Excel format, a text box in a group footer containing an expression with the Sum function is included in the object. Keine anderen Steuerelemente in einer Kopf- oder Fußzeile (und keine andere Aggregatfunktion als Summe) werden in das Objekt eingeschlossen.No other control in a header or footer (and no aggregate function other than Sum) is included in the object.

  • Unterberichte sind im Objekt eingeschlossen.Subreports are included in the object. Unterformulare sind eingeschlossen, wenn eine Ausgabe in ASP erfolgt, aber nur bei Ausgabe als Formular (nicht als Datenblatt).Subforms are included when outputting to .asp, but only when outputting as a form (not a datasheet).

  • Wenn Sie ein Datenblatt, ein Formular oder eine Datenzugriffsseite im HTML-Format senden, wird eine HTML-Datei erstellt.When you send a datasheet, form, or data access page in HTML format, one .html file is created. Wenn Sie einen Bericht im HTML-Format senden, wird für jede Seite im Bericht eine HTML-Datei erstellt.When you send a report in HTML format, one .html file is created for each page in the report.

Module können nur im MS-DOS-Textformat ausgegeben werden. Wenn Sie also für das Argument ObjectType den Wert acSendModule angeben, müssen Sie für das Argument OutputFormat den Wert acFormatTXT angeben.Modules can be sent only in MS-DOS Text format, so if you specify acSendModule for the ObjectType argument, you must specify acFormatTXT for the OutputFormat argument.

Hinweis

In einem 2007 Microsoft Office System-Programm müssen Sie zuerst das Add-In installieren, um eine Datei im Format PDF oder XPS speichern zu können.You can save as a PDF or XPS file from a 2007 Microsoft Office system program only after you install an add-in. Weitere Informationen finden Sie unter 2007 Microsoft Office-Add-in: Microsoft Save as PDF or XPS.For more information, see 2007 Microsoft Office Add-in: Microsoft Save as PDF or XPS.

BeispielExample

Das folgende Codebeispiel enthält die Employees -Tabelle in einer e-Mail-Nachricht im Microsoft Excel-Format und gibt an, CCund Betreff -Zeilen in der e-Mail-Nachricht.The following code example includes the Employees table in a mail message in Microsoft Excel format and specifies To, Cc, and Subject lines in the mail message. Die Nachricht wird sofort ohne vorherige Bearbeitung gesendet.The mail message is sent immediately, without editing.

DoCmd.SendObject acSendTable, "Employees", acFormatXLS, _ 
    "Nancy Davolio; Andrew Fuller", "Joan Weber", , _ 
    "Current Spreadsheet of Employees", , False

Im folgenden Beispiel wird gezeigt, wie eine E-Mail mit Microsoft Outlook erstellt und dem Benutzer angezeigt wird.The following example shows how to create an email message with Microsoft Outlook and display it to the user.

Public Function CreateEmailWithOutlook( _
    MessageTo As String, _
    Subject As String, _
    MessageBody As String)

    ' Define app variable and get Outlook using the "New" keyword
    Dim olApp As New Outlook.Application
    Dim olMailItem As Outlook.MailItem  ' An Outlook Mail item
 
    ' Create a new email object
    Set olMailItem = olApp.CreateItem(olMailItem)

    ' Add the To/Subject/Body to the message and display the message
    With olMailItem
        .To = MessageTo
        .Subject = Subject
        .Body = MessageBody
        .Display    ' To show the email message to the user
    End With

    ' Release all object variables
    Set olMailItem = Nothing
    Set olApp = Nothing

End Function

Im folgenden Beispiel wird gezeigt, wie eine E-Mail mit Microsoft Outlook erstellt und gesendet wird, ohne dass die E-Mail dem Benutzer angezeigt wird.The following example shows how to create an email message with Microsoft Outlook and send it without displaying the email message to the user.

Public Function SendEmailWithOutlook( _
    MessageTo As String, _
    Subject As String, _
    MessageBody As String)

    ' Define app variable and get Outlook using the "New" keyword
    Dim olApp As New Outlook.Application
    Dim olMailItem As Outlook.MailItem  ' An Outlook Mail item
 
    ' Create a new email object
    Set olMailItem = olApp.CreateItem(olMailItem)

    ' Add the To/Subject/Body to the message and display the message
    With olMailItem
        .To = MessageTo
        .Subject = Subject
        .Body = MessageBody
        .Send       ' Send the message immediately
    End With

    ' Release all object variables
    Set olMailItem = Nothing
    Set olApp = Nothing

End Function

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.