En esta página

QHttpMultiPart Class

La clase QHttpMultiPart emula un mensaje MIME multiparte que se va a enviar a través de HTTP. Más información...

Encabezado: #include <QHttpMultiPart>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network
Heredado de: QObject

Tipos públicos

enum ContentType { MixedType, RelatedType, FormDataType, AlternativeType }

Funciones públicas

QHttpMultiPart(QObject *parent = nullptr)
QHttpMultiPart(QHttpMultiPart::ContentType contentType, QObject *parent = nullptr)
virtual ~QHttpMultiPart()
void append(const QHttpPart &httpPart)
QByteArray boundary() const
void setBoundary(const QByteArray &boundary)
void setContentType(QHttpMultiPart::ContentType contentType)

Descripción detallada

QHttpMultiPart se asemeja a un mensaje multiparte MIME, tal y como se describe en el RFC 2046, que se envía a través de HTTP. Un mensaje multiparte consta de un número arbitrario de partes de cuerpo (véase QHttpPart), separadas por un delimitador único. El delimitador de QHttpMultiPart se construye con la cadena «boundary_.oOo._» seguida de caracteres aleatorios, y proporciona suficiente singularidad para garantizar que no aparezca dentro de las propias partes. Si se desea, el delimitador se puede seguir configurando mediante setBoundary().

A modo de ejemplo, consideremos el siguiente fragmento de código, que crea un mensaje multiparte que contiene una parte de texto seguida de una parte de imagen:

QHttpMultiPart *multiPart = new QHttpMultiPart(QHttpMultiPart::FormDataType);

QHttpPart textPart;
textPart.setHeader(QNetworkRequest::ContentDispositionHeader, QVariant("form-data; name=\"text\""));
textPart.setBody("my text");

QHttpPart imagePart;
imagePart.setHeader(QNetworkRequest::ContentTypeHeader, QVariant("image/jpeg"));
imagePart.setHeader(QNetworkRequest::ContentDispositionHeader, QVariant("form-data; name=\"image\""));
QFile *file = new QFile("image.jpg");
file->open(QIODevice::ReadOnly);
imagePart.setBodyDevice(file);
file->setParent(multiPart); // we cannot delete the file now, so delete it with the multiPart

multiPart->append(textPart);
multiPart->append(imagePart);

QUrl url("http://my.server.tld");
QNetworkRequest request(url);

QNetworkAccessManager manager;
QNetworkReply *reply = manager.post(request, multiPart);
multiPart->setParent(reply); // delete the multiPart with the reply
// here connect signals etc.

Véase también QHttpPart y QNetworkAccessManager::post().

Documentación sobre tipos de miembros

enum QHttpMultiPart::ContentType

Lista de tipos de contenido conocidos para un subtipo multiparte, tal y como se describe en el RFC 2046 y otros documentos.

ConstanteValorDescripción
QHttpMultiPart::MixedType0corresponde al subtipo «multipart/mixed», lo que significa que las partes del cuerpo son independientes entre sí, tal y como se describe en el RFC 2046.
QHttpMultiPart::RelatedType1corresponde al subtipo «multipart/related», lo que significa que las partes del cuerpo están relacionadas entre sí, tal y como se describe en el RFC 2387.
QHttpMultiPart::FormDataType2corresponde al subtipo «multipart/form-data», lo que significa que las partes del cuerpo contienen elementos de formulario, tal y como se describe en el RFC 2388.
QHttpMultiPart::AlternativeType3corresponde al subtipo «multipart/alternative», lo que significa que las partes del cuerpo son representaciones alternativas de la misma información, tal y como se describe en el RFC 2046.

Véase también setContentType().

Documentación de las funciones miembro

[explicit] QHttpMultiPart::QHttpMultiPart(QObject *parent = nullptr)

Crea un objeto `QHttpMultiPart` con el tipo de contenido ` MixedType ` y establece ` parent ` como objeto padre.

Véase también QHttpMultiPart::ContentType.

[explicit] QHttpMultiPart::QHttpMultiPart(QHttpMultiPart::ContentType contentType, QObject *parent = nullptr)

Crea un objeto QHttpMultiPart con el tipo de contenido contentType y establece «parent» como objeto padre.

Véase también QHttpMultiPart::ContentType.

[virtual noexcept] QHttpMultiPart::~QHttpMultiPart()

Elimina el archivo multiparte.

void QHttpMultiPart::append(const QHttpPart &httpPart)

Añade « httpPart » a este mensaje multiparte.

QByteArray QHttpMultiPart::boundary() const

devuelve el límite.

Véase también setBoundary().

void QHttpMultiPart::setBoundary(const QByteArray &boundary)

Establece el límite en boundary.

Por lo general, no es necesario generar el límite manualmente; al crearse, el límite se inicia con la cadena «boundary_.oOo._» seguida de caracteres aleatorios, lo que proporciona suficiente singularidad para garantizar que no aparezca dentro de las propias partes.

Véase también boundary().

void QHttpMultiPart::setContentType(QHttpMultiPart::ContentType contentType)

Establece el tipo de contenido en contentType. El tipo de contenido se utilizará en la sección de encabezados HTTP al enviar el mensaje multiparte mediante QNetworkAccessManager::post(). En caso de que desees utilizar un subtipo multiparte que no figure en QHttpMultiPart::ContentType, puedes añadir manualmente el campo de encabezado «Content-Type» a QNetworkRequest y, a continuación, utilizar esta solicitud junto con el mensaje multiparte para realizar la publicación.

Véase también QHttpMultiPart::ContentType y QNetworkAccessManager::post().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.