En esta página

QFormDataPartBuilder Class

La clase `QFormDataPartBuilder` es una clase de utilidad diseñada para simplificar la creación de objetos ` QHttpPart `. Más información...

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

Funciones públicas

QFormDataPartBuilder()
QFormDataPartBuilder(const QFormDataPartBuilder &other)
QFormDataPartBuilder(QFormDataPartBuilder &&other)
~QFormDataPartBuilder()
QFormDataPartBuilder setBody(QByteArrayView data, QAnyStringView fileName = {}, QAnyStringView mimeType = {})
QFormDataPartBuilder setBodyDevice(QIODevice *body, QAnyStringView fileName = {}, QAnyStringView mimeType = {})
QFormDataPartBuilder setHeaders(const QHttpHeaders &headers)
QFormDataPartBuilder &operator=(QFormDataPartBuilder &&other)
QFormDataPartBuilder &operator=(const QFormDataPartBuilder &other)

Descripción detallada

La clase QFormDataPartBuilder se puede utilizar para crear un objeto ` QHttpPart ` con el encabezado de disposición de contenido establecido de forma predeterminada en «form-data». A continuación, el objeto generado se puede utilizar como parte de un mensaje multiparte (representado por la clase ` QHttpMultiPart `).

Véase también QHttpPart, QHttpMultiPart y QFormDataBuilder.

Documentación de las funciones miembro

[constexpr noexcept default] QFormDataPartBuilder::QFormDataPartBuilder()

Crea por defecto una instancia de ` QFormDataPartBuilder`.

[implicit] QFormDataPartBuilder::QFormDataPartBuilder(const QFormDataPartBuilder &other)

Crea una copia de other. El objeto es válido mientras no se haya destruido el QFormDataBuilder asociado.

Los datos de la copia se comparten (copia superficial): si se modifica una parte, también se modificará la otra.

QFormDataPartBuilder foo()
{
    QFormDataBuilder builder;
    auto qfdpb1 = builder.part("First"_L1);
    auto qfdpb2 = qfdpb1; // this creates a shallow copy

    qfdpb2.setBodyDevice(&image, "cutecat.jpg"); // qfdpb1 is also modified

    return qfdbp2;  // invalid, builder is destroyed at the end of the scope
}

[noexcept implicit] QFormDataPartBuilder::QFormDataPartBuilder(QFormDataPartBuilder &&other)

Crea una instancia de `QFormDataPartBuilder` mediante la construcción por movimiento, de modo que apunte al mismo objeto al que apuntaba ` other `.

[noexcept implicit] QFormDataPartBuilder::~QFormDataPartBuilder()

Elimina el objeto « QFormDataPartBuilder ».

QFormDataPartBuilder QFormDataPartBuilder::setBody(QByteArrayView data, QAnyStringView fileName = {}, QAnyStringView mimeType = {})

Establece data como cuerpo de esta parte MIME y, si se ha especificado, fileName como parámetro de nombre de archivo en el encabezado «content-disposition».

Si no se proporciona mimeType (está vacío), QFormDataPartBuilder intenta detectar automáticamente el tipo MIME de data utilizando QMimeDatabase.

Una llamada posterior a ` setBodyDevice()` descarta el cuerpo y, en su lugar, se utilizará el dispositivo.

Para grandes cantidades de datos (por ejemplo, una imagen), es preferible utilizar setBodyDevice(), ya que no copia los datos internamente.

Véase también setBodyDevice().

QFormDataPartBuilder QFormDataPartBuilder::setBodyDevice(QIODevice *body, QAnyStringView fileName = {}, QAnyStringView mimeType = {})

Establece body como el dispositivo de cuerpo de esta parte y fileName como el parámetro de nombre de archivo en el encabezado «Content-Disposition».

Si no se proporciona mimeType (está vacío), QFormDataPartBuilder intenta detectar automáticamente el tipo MIME de body utilizando QMimeDatabase.

Una llamada posterior a ` setBody()` descarta el dispositivo del cuerpo y, en su lugar, se utilizarán los datos establecidos por ` setBody()`.

Para grandes cantidades de datos, es preferible este método al de setBody(), ya que al utilizarlo el contenido no se copia, sino que se lee directamente del dispositivo.

body debe estar abierto y ser legible. QFormDataPartBuilder no asume la propiedad de body, es decir, el dispositivo debe cerrarse y destruirse si es necesario.

Nota: Si body es secuencial (p. ej., sockets, pero no archivos), se debe llamar a QNetworkAccessManager::post() después de que body haya emitido finished().

Véase también setBody() y QHttpPart::setBodyDevice().

QFormDataPartBuilder QFormDataPartBuilder::setHeaders(const QHttpHeaders &headers)

Establece los encabezados especificados en headers.

Nota: Los encabezados «content-type» y «content-disposition», si se han especificado en headers, serán sobrescritos por la clase.

[implicit] QFormDataPartBuilder &QFormDataPartBuilder::operator=(QFormDataPartBuilder &&other)

Asigna « other » a esta instancia de « QFormDataPartBuilder ». ». ». ». ». ». ». ». ». ». ». ». ». ». ». ». ». ». ». ». ». ». ». ». ».xml-ph-0001@dee

[implicit] QFormDataPartBuilder &QFormDataPartBuilder::operator=(const QFormDataPartBuilder &other)

Asigna other a QFormDataPartBuilder y devuelve una referencia a este QFormDataPartBuilder. El objeto es válido mientras el QFormDataBuilder asociado no haya sido destruido.

Los datos de la copia son compartidos (copia superficial): al modificar una parte, también se modificará la otra.

QFormDataPartBuilder foo()
{
    QFormDataBuilder builder;
    auto qfdpb1 = builder.part("First"_L1);
    auto qfdpb2 = qfdpb1; // this creates a shallow copy

    qfdpb2.setBodyDevice(&image, "cutecat.jpg"); // qfdpb1 is also modified

    return qfdbp2;  // invalid, builder is destroyed at the end of the scope
}

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