En esta página

QHttpPart Class

La clase QHttpPart contiene una parte del cuerpo que se utilizará dentro de un mensaje MIME HTTP multiparte. Más información...

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

Funciones públicas

QHttpPart()
QHttpPart(const QHttpPart &other)
~QHttpPart()
void setBody(const QByteArray &body)
void setBodyDevice(QIODevice *device)
void setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)
void setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)
void swap(QHttpPart &other)
bool operator!=(const QHttpPart &other) const
QHttpPart &operator=(const QHttpPart &other)
bool operator==(const QHttpPart &other) const
(since 6.8) QDebug operator<<(QDebug debug, const QHttpPart &part)

Descripción detallada

La clase QHttpPart contiene una parte del cuerpo que se utilizará dentro de un mensaje MIME multiparte HTTP (representado por la clase QHttpMultiPart ). Un QHttpPart consta de un bloque de encabezado y un bloque de datos, separados entre sí por dos líneas nuevas consecutivas. Un ejemplo de una parte sería:

Content-Type: text/plain
Content-Disposition: form-data; name="text"

here goes the body

Para configurar los encabezados, utilice setHeader() y setRawHeader(), que se comportan exactamente igual que QNetworkRequest::setHeader() y QNetworkRequest::setRawHeader().

Para leer pequeños fragmentos de datos, utilice setBody(); para bloques de datos más grandes, como por ejemplo imágenes, utilice setBodyDevice(). Este último método ahorra memoria al no copiar los datos internamente, sino al leerlos directamente desde el dispositivo. Esto significa que el dispositivo debe estar abierto y en modo de lectura en el momento en que el mensaje multiparte que contiene la parte del cuerpo se envía a la red mediante QNetworkAccessManager::post().

Para crear un QHttpPart con un cuerpo pequeño, considere el siguiente fragmento de código (esto genera los datos que se muestran en el ejemplo anterior):

QHttpPart textPart;
textPart.setHeader(QNetworkRequest::ContentTypeHeader, QVariant("text/plain"));
textPart.setHeader(QNetworkRequest::ContentDispositionHeader, QVariant("form-data; name=\"text\""));
textPart.setBody("here goes the body");

Para crear un QHttpPart que lea desde un dispositivo (por ejemplo, un archivo), se puede aplicar lo siguiente:

QHttpPart imagePart;
imagePart.setHeader(QNetworkRequest::ContentTypeHeader, QVariant("image/jpeg"));
imagePart.setHeader(QNetworkRequest::ContentDispositionHeader, QVariant("form-data; name=\"image\""));
imagePart.setRawHeader("Content-ID", "my@content.id"); // add any headers you like via setRawHeader()
QFile *file = new QFile("image.jpg");
file->open(QIODevice::ReadOnly);
imagePart.setBodyDevice(file);

Ten en cuenta que QHttpPart no asume la propiedad del dispositivo al configurarlo, por lo que es responsabilidad del desarrollador destruirlo cuando ya no sea necesario. Una buena idea podría ser establecer el mensaje multiparte como objeto padre del dispositivo, tal y como se describe en la documentación de QHttpMultiPart.

Véase también QHttpMultiPart y QNetworkAccessManager.

Documentación de las funciones miembro

QHttpPart::QHttpPart()

Crea un objeto QHttpPart vacío.

QHttpPart::QHttpPart(const QHttpPart &other)

Crea una copia de other.

[noexcept] QHttpPart::~QHttpPart()

Elimina esto: QHttpPart.

void QHttpPart::setBody(const QByteArray &body)

Establece el cuerpo de esta parte MIME en body. Se utilizará el cuerpo establecido con este método, a menos que el dispositivo se configure mediante setBodyDevice(). Para una gran cantidad de datos (por ejemplo, una imagen), utiliza setBodyDevice(), que no copiará los datos internamente.

Véase también setBodyDevice().

void QHttpPart::setBodyDevice(QIODevice *device)

Configura el dispositivo para leer el contenido de device. Para grandes cantidades de datos, es preferible utilizar este método en lugar de setBody(), ya que al utilizarlo el contenido no se copia, sino que se lee directamente del dispositivo. device debe estar abierto y ser legible. QHttpPart no asume la propiedad de device; es decir, el dispositivo debe cerrarse y eliminarse si es necesario. Si device es secuencial (por ejemplo, sockets, pero no archivos), se debe llamar a QNetworkAccessManager::post() después de que device haya emitido finished(). Para desactivar el dispositivo y utilizar los datos establecidos mediante setBody(), utiliza «setBodyDevice(0)».

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

void QHttpPart::setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)

Establece el valor del encabezado conocido « header » en « value », anulando cualquier encabezado establecido anteriormente.

Véase también QNetworkRequest::KnownHeaders, setRawHeader() y QNetworkRequest::setHeader().

void QHttpPart::setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)

Establece el valor del encabezado « headerName » en « headerValue ». Si « headerName » corresponde a un encabezado conocido (véase QNetworkRequest::KnownHeaders), se analizará el formato sin procesar y se establecerá también el encabezado «preprocesado» correspondiente.

Nota: Establecer el mismo encabezado dos veces anula la configuración anterior. Para conseguir el comportamiento de varios encabezados HTTP con el mismo nombre, debes concatenar los dos valores, separándolos con una coma («,») y establecer un único encabezado sin procesar.

Véase también QNetworkRequest::KnownHeaders, setHeader() y QNetworkRequest::setRawHeader().

[noexcept] void QHttpPart::swap(QHttpPart &other)

Sustituye esta parte del HTTP por other. Esta operación es muy rápida y nunca falla.

bool QHttpPart::operator!=(const QHttpPart &other) const

Devuelve ` true ` si este objeto no es el mismo que ` other`.

Véase también operator==().

QHttpPart &QHttpPart::operator=(const QHttpPart &other)

Crea una copia de other.

bool QHttpPart::operator==(const QHttpPart &other) const

Devuelve « true » si este objeto es idéntico a « other » (es decir, si tienen los mismos encabezados y el mismo cuerpo).

Véase también operator!=().

Elementos no miembros relacionados

[since 6.8] QDebug operator<<(QDebug debug, const QHttpPart &part)

Escribe el ` part ` en el objeto ` debug ` con fines de depuración. A menos que se haya configurado un dispositivo, se muestra el tamaño del cuerpo.

Esta función se introdujo en Qt 6.8.

Véase también Técnicas de depuración.

© 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.